---
title: "Project structure"
description: "The files of a wervt app and what they do."
canonical_url: "https://docs.lightdrop.cloud/getting-started/project-structure"
---
# Project structure

> The files of a wervt app and what they do.

```bash
my-app/
├── app.vue                     # the app shell: renders the current page
├── pages/index.vue             # the start page; every file in pages/ is a route
├── server/
│   ├── api/
│   │   ├── todos.post.ts       # API routes (nuxt/server)
│   │   ├── todos/[id].patch.ts
│   │   ├── example-secret.get.ts # reads runtimeConfig, replace it
│   │   └── shapes/todos.get.ts # live data routes (proxyShape)
│   ├── tools/list-todos.ts     # tools for agents (defineTool; routes: defineToolRoute)
│   ├── tasks/db/seed.ts        # example data for new databases (db:seed)
│   └── db/schema.ts            # Drizzle schema
├── drizzle/                    # generated migrations, commit them
├── drizzle.config.ts
├── nuxt.config.ts              # modules: ['@wervt/nuxt']
├── AGENTS.md                   # instructions for coding agents
└── vite.config.ts              # Vite+ (format, lint, type check)
```

## `nuxt.config.ts`

```ts
export default defineNuxtConfig({
  modules: ['@wervt/nuxt'],
  runtimeConfig: {
    exampleSecret: '',
    public: {},
  },
  compatibilityDate: '2026-10-01',
})
```

`runtimeConfig` holds the app's settings and secrets, set per app with
`wervt env my-app --set NUXT_EXAMPLE_SECRET=…` (see [Configuration and secrets](https://docs.lightdrop.cloud/guides/configuration)).

The module sets the Deno build preset, adds the Node globals the isolate lacks, auto-imports
`useShape` and wires up local development. There is nothing else to configure.

## `AGENTS.md`

Every app ships instructions for coding agents: which APIs to use, how migrations and live data
work, and what doesn't run in an isolate. `CLAUDE.md` points to it. The same content is available as
an [agent skill](https://docs.lightdrop.cloud/guides/agents).


## Sitemap

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