---
title: "Quickstart"
description: "Sign in to a wervt server, create an app and ship it, with Vite+."
canonical_url: "https://docs.dev.lightdrop.cloud/getting-started/quickstart"
---
# Quickstart

> Sign in to a wervt server, create an app and ship it, with Vite+.

You need access to a wervt server: its dashboard and the control plane URL (e.g.
`https://api.dev.lightdrop.cloud`). Running your own? See [Self-hosting](https://docs.dev.lightdrop.cloud/self-hosting/architecture) first.

wervt apps are built with [Vite+](https://viteplus.dev), so the commands here use its `vp` and
`vpx` by default. Its installer brings Node.js and pnpm along, nothing else to set up. Prefer npm
and pnpm? Switch any command block to **npm**, the others follow.

<code-group sync="pm">

```bash [Vite+]
curl -fsSL https://vite.plus | bash   # Windows: irm https://vite.plus/ps1 | iex
```

```bash [npm]
# Node.js 22 or newer, then pnpm:
npm install -g pnpm
```

</code-group>

<steps>

### Sign in

<code-group sync="pm">

```bash [Vite+]
vpx @wervt/cli login --url https://api.dev.lightdrop.cloud
```

```bash [npm]
npx @wervt/cli login --url https://api.dev.lightdrop.cloud
```

</code-group>

The terminal shows a code. Open the dashboard's **Settings** page, enter it and approve. The session is
saved in `~/.config/wervt`, so every later `wervt` command on this machine is signed in.

### Let your agent build it

<code-group sync="pm">

```bash [Vite+]
vpx @wervt/cli skill install
```

```bash [npm]
npx @wervt/cli skill install
```

</code-group>

This installs the wervt skill for Claude Code and other agents (see [Agents](https://docs.dev.lightdrop.cloud/guides/agents)). Then
just ask: *"Build a guest list for my birthday with RSVPs, and ship it on wervt."* The agent
scaffolds the app, writes it, deploys it and gives you the URL.

### Or by hand

<code-group sync="pm">

```bash [Vite+]
vp create wervt todos
cd todos
vp exec wervt deploy
```

```bash [npm]
pnpm create wervt todos
cd todos
pnpm exec wervt deploy
```

</code-group>

`create-wervt` copies the app template: a todo list with a Drizzle schema, validated API routes, a
live shape, an `AGENTS.md` for your agent and a GitHub Actions workflow that deploys on push (see
[Deploys](https://docs.dev.lightdrop.cloud/guides/deploys)). `wervt deploy` builds the app for the isolate runtime and uploads it.
The control plane migrates its database with the app's own role and activates the release at
`https://todos.dev.lightdrop.cloud`.

### Open it up

New apps are private: only you (and the server's admins) get in after signing in.

<code-group sync="pm">

```bash [Vite+]
vp exec wervt access todos --add friend@example.com   # let someone in
vp exec wervt access todos --public                   # or everyone
```

```bash [npm]
pnpm exec wervt access todos --add friend@example.com   # let someone in
pnpm exec wervt access todos --public                   # or everyone
```

</code-group>

The first deploy of a name makes it yours. Add people who should deploy and manage it with
`wervt members todos --add …` (see [Owners and members](https://docs.dev.lightdrop.cloud/guides/private-apps#owners-and-members)).

</steps>

## Develop locally

Optional: deploying is enough to try things out, and agents check their work on the deployed app.
For a faster loop, run the app's dev server (`nuxt dev`; with Vite+ that's `vpr dev`, since
`vp dev` would start a bare Vite server instead). It starts without anything else; pages and API
routes work right away.

The database, live data and files need a Postgres, Electric and Garage. The local wervt stack has
all three: start it once with Docker, as described in [Local stack](https://docs.dev.lightdrop.cloud/self-hosting/local-stack), and
the dev server creates the app's role and schema, runs its migrations (again whenever `drizzle/`
changes) and connects to Electric. Without it, the dev server says so and starts anyway.

<code-group sync="pm">

```bash [Vite+]
vpr dev
vpr db:generate   # after changing server/db/schema.ts
vp check --fix    # format, lint and type check
```

```bash [npm]
pnpm dev
pnpm db:generate  # after changing server/db/schema.ts
pnpm exec vp check --fix
```

</code-group>


## Sitemap

See the full [sitemap](https://docs.dev.lightdrop.cloud/sitemap.md) for all pages.
