void 0.7.12 → 0.8.0

package/skills/void/docs/reference/api.md

@@ -4,7 +4,7 @@ outline: deep
 
 # API Reference
 
-This page is the source of truth for public `void` exports. Use it when you already know what feature you want and need the exact import, signature, or return type.
+This page is the source of truth for user-facing `void` exports. Use it when you already know what feature you want and need the exact import, signature, or return type. Some exported subpaths are implementation support for adapters, generated workers, or internal runtime wiring and are intentionally not listed as app APIs.
 
 ## Plugin
 
@@ -193,7 +193,8 @@ function defineRender(
 
 ```ts
 interface RenderAssetTags {
-  head: string; // Script and style tags for <head>
+  css: string; // Stylesheet links for <head>
+  preloads: string; // Modulepreload and dev client tags for <head>
   body: string; // Script tags for before </body>
 }
 ```
@@ -533,11 +534,11 @@ The typed client is built on [ofetch](https://github.com/unjs/ofetch) with a typ
 
 ## Database
 
-Imported from `"void/db"`. The `db` export is a [Drizzle ORM](https://orm.drizzle.team) instance for [Cloudflare D1](https://developers.cloudflare.com/d1/). See the [Database guide](../guide/database.md) for usage and the [Drizzle docs](https://orm.drizzle.team/docs/select) for the full query API.
+Imported from `"void/db"`. The `db` export is a [Drizzle ORM](https://orm.drizzle.team) instance for the configured database dialect: [Cloudflare D1](https://developers.cloudflare.com/d1/) by default, or PostgreSQL when `void.json` sets `"database": "pg"` / `"postgresql"`. See the [Database guide](../guide/database.md) for usage and the [Drizzle docs](https://orm.drizzle.team/docs/select) for the full query API.
 
 ### `db`
 
-Default Drizzle D1 instance, pre-wired with the `env.DB` binding and your schema from `db/schema.ts`.
+Default Drizzle instance, pre-wired with your schema from `db/schema.ts`.
 
 ```ts
 import { db } from 'void/db';
@@ -546,11 +547,18 @@ import { users } from '@schema';
 const allUsers = await db.select().from(users).all();
 ```
 
-When the Void plugin is active, `void/db` is served as a virtual module that auto-wires the D1 binding with your schema. The published npm fallback uses a lazy proxy that resolves the `DB` binding at first access.
+When the Void plugin is active, `void/db` is served as a virtual module that auto-wires the active database with your schema.
+
+- D1 projects resolve the `DB` binding and expose `DrizzleD1Database<Schema>`.
+- PostgreSQL projects use `DATABASE_URL` during local development and Hyperdrive's `connectionString` in production, exposing `NodePgDatabase<Schema>`.
+
+The published npm fallback uses a lazy D1 proxy that resolves the `DB` binding at first access.
 
 ### `createDb(database)`
 
-Creates a Drizzle D1 instance from a specific D1 binding. Use this when you have multiple D1 databases or need a non-default binding.
+Creates a Drizzle instance for the active dialect.
+
+For D1 projects, pass a specific D1 binding. Use this when you have multiple D1 databases or need a non-default binding.
 
 ```ts
 import { createDb } from 'void/db';
@@ -559,10 +567,22 @@ import { env } from 'cloudflare:workers';
 const db = createDb(env.MY_OTHER_DB);
 ```
 
+For PostgreSQL projects, pass a connection string.
+
+```ts
+import { createDb } from 'void/db';
+
+const db = createDb('postgres://user:password@host:5432/app');
+```
+
 **Signature:**
 
 ```ts
-function createDb(d1: D1Database): DrizzleD1Database;
+// D1
+function createDb(d1: D1Database): DrizzleD1Database<Schema>;
+
+// PostgreSQL
+function createDb(connectionString: string): NodePgDatabase<Schema>;
 ```
 
 ### Query Operators
@@ -602,6 +622,98 @@ The callback receives:
 
 Seed modules can export either `default` or a named `seed` function.
 
+## KV
+
+Imported from `"void/kv"`.
+
+### `kv`
+
+Typed JSON-aware client for the inferred `KV` binding.
+
+```ts
+import { kv } from 'void/kv';
+
+await kv.put('settings', { theme: 'dark' });
+const settings = await kv.get<{ theme: string }>('settings');
+```
+
+**Key exports:** `kv`, `createKV(namespace)`, `KVClient`, `KVMap`, `PutOptions`, `ListOptions`.
+
+`kv.map(prefix)` creates a typed namespaced view where every key is stored under `prefix:`.
+
+## Storage
+
+Imported from `"void/storage"`.
+
+### `storage`
+
+Default [R2 bucket](https://developers.cloudflare.com/r2/) proxy for the inferred `STORAGE` binding.
+
+```ts
+import { storage } from 'void/storage';
+
+await storage.put('avatars/alice.png', file);
+const object = await storage.get('avatars/alice.png');
+```
+
+**Key exports:** `storage`, `createStorage(bucket)`.
+
+## AI
+
+Imported from `"void/ai"`.
+
+### `ai`
+
+Typed AI client for Workers AI models and AI Gateway-backed third-party providers.
+
+```ts
+import { ai } from 'void/ai';
+
+const result = await ai.run('@cf/meta/llama-3.1-8b-instruct', {
+  messages: [{ role: 'user', content: 'Summarize this release note.' }],
+});
+```
+
+**Key exports:** `ai`, `VoidAi`, model input/response types. See [AI](../guide/ai.md) for provider setup and streaming examples.
+
+## ISR
+
+Imported from `"void/isr"`.
+
+### `revalidate(options)`
+
+Revalidate ISR-cached pages on demand. In local development this is a no-op because there is no edge ISR cache.
+
+```ts
+import { revalidate } from 'void/isr';
+
+await revalidate({ paths: ['/', '/blog/hello'] });
+await revalidate({ all: true });
+```
+
+**Signature:**
+
+```ts
+function revalidate(options: { paths?: string[]; all?: boolean }): Promise<void>;
+```
+
+## Logging
+
+Imported from `"void/log"`.
+
+### `logger`
+
+Structured logger that emits one JSON line per call so deployed logs can be filtered by message and fields.
+
+```ts
+import { logger } from 'void/log';
+
+logger.info('checkout completed', { orderId, userId });
+logger.error('webhook failed', { provider: 'stripe', attempt: 3 });
+```
+
+**Methods:** `logger.error(message, fields?)`, `logger.warn(message, fields?)`, `logger.info(message, fields?)`.
+
 ## Types
 
 ### `CloudContext`
@@ -691,9 +803,42 @@ Empty stub interface augmented at build time by the generated `.void/routes.d.ts
 import type { RouteMap } from 'void/routes';
 ```
 
-## Environment Types
+## Environment
+
+Imported from `"void/env"`.
+
+### `defineEnv(schema)`
 
-Importing `"void/env"` provides global Cloudflare environment types:
+Register an env schema and return the typed [`env`](#env) proxy. Void auto-discovers `env.ts`, imports it during dev/build/deploy, generates `.void/env.d.ts`, validates production secrets before deploy, and validates values at worker boot.
+
+```ts
+import { defineEnv, string, number, oneOf, url } from 'void/env';
+
+export default defineEnv({
+  STRIPE_KEY: string().secret(),
+  PORT: number().default(3000),
+  NODE_ENV: oneOf(['development', 'production']),
+  VITE_PUBLIC_URL: url().public(),
+});
+```
+
+### `env`
+
+Typed runtime proxy for declared env keys. Unknown keys and bindings pass through as `unknown`.
+
+```ts
+import { env } from 'void/env';
+
+const port = env.PORT;
+```
+
+### Schema helpers
+
+`void/env` includes Standard Schema-compatible helpers: `string()`, `number()`, `boolean()`, `url()`, `email()`, `oneOf([...])`, and `json<T>()`. Each helper supports `.optional()`, `.default(value)`, `.secret()`, and `.public()`.
+
+### Types
+
+`void/env` also provides global Cloudflare environment types:
 
 ```ts
 /// <reference types="void/env" />
@@ -732,6 +877,7 @@ function voidVue(options?: VoidVueOptions): Plugin[];
 ```ts
 interface VoidVueOptions {
   vue?: VuePluginOptions; // passed through to @vitejs/plugin-vue
+  viewTransitions?: boolean; // enable View Transitions API for navigations
 }
 ```
 
@@ -746,6 +892,8 @@ Imported from `"@void/vue"`.
 | `useParams()`                      | Returns dynamic route params for the page currently being rendered.                                                                                                                                                                               |
 | `useNavigation()`                  | Returns pending navigation state: `{ state, location, method }`, where `state` is `"idle"`, `"loading"`, or `"submitting"` and `location` is the pending destination.                                                                             |
 | `useForm(url, defaults, options?)` | Typed reactive form helper bound to a page action URL. Returns `{ data, post, put, patch, delete, pending, errors, error, hasChanges, wasSuccessful, recentlySuccessful, reset, clearErrors, clearError }`.                                       |
+| `useIslandForm(defaults)`          | Form helper for island components where the action URL is inferred from the current island request. Returns the same form state and submit helpers as `useForm()`.                                                                                |
+| `action(url, options?)`            | Awaitable one-shot page action helper. Uses `POST` by default and accepts `{ data, method, params }`, where `method` can be `"PUT"`, `"PATCH"`, or `"DELETE"`. Returns an `ActionResult`.                                                         |
 | `useShared()`                      | Returns shared data injected by middleware via `c.set("shared", {...})`.                                                                                                                                                                          |
 
 Vue `Link` GET `data` is merged into the rendered `href` query string. Primitive values are serialized with `String(value)`, arrays become repeated keys, `null` and `undefined` are omitted, and nested objects throw. `prefetch` and `reloadDocument` are GET-only and throw for mutation links.
@@ -794,6 +942,7 @@ Imported from `"@void/react"`.
 | `useParams()`                      | Returns dynamic route params for the page currently being rendered.                                                                                                                                                                                 |
 | `useNavigation()`                  | Returns pending navigation state: `{ state, location, method }`, where `state` is `"idle"`, `"loading"`, or `"submitting"` and `location` is the pending destination.                                                                               |
 | `useForm(url, defaults, options?)` | Form helper hook. Returns `{ data, setData, post, put, patch, delete, pending, errors, error, hasChanges, wasSuccessful, recentlySuccessful, reset, clearErrors, clearError }`.                                                                     |
+| `useIslandForm(defaults)`          | Form helper hook for island components where the action URL is inferred from the current island request. Returns the same form state and submit helpers as `useForm()`.                                                                             |
 | `action(url, options?)`            | Awaitable one-shot page action helper. Uses `POST` by default and accepts `{ data, method, params }`, where `method` can be `"PUT"`, `"PATCH"`, or `"DELETE"`. Returns an `ActionResult`.                                                           |
 | `useShared()`                      | Returns shared data injected by middleware via `c.set("shared", {...})`.                                                                                                                                                                            |
 | `Deferred<T>`                      | React-only prop type for `defer()` results. It is `Promise<T>` and is consumed with React `use()`.                                                                                                                                                  |
@@ -835,6 +984,10 @@ function voidSvelte(options?: VoidSvelteOptions): Plugin[];
 interface VoidSvelteOptions {
   svelte?: SveltePluginOptions; // passed through to @sveltejs/vite-plugin-svelte
   viewTransitions?: boolean; // enable View Transitions API
+  prefetch?: {
+    hoverDelay?: number;
+    cacheFor?: number | string | [string, string];
+  };
 }
 ```
 
@@ -846,6 +999,8 @@ Imported from `"@void/svelte"`.
 | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `Link`                             | Svelte component for SPA navigation. Renders `<a>` for GET, `<button>` for non-GET methods. Props: `href`, `method`, `data`, `prefetch`, `cacheFor`, `preserveScroll`, `preserveState`, `replace`, `reloadDocument`, `viewTransition`, `onNavigate`. |
 | `useForm(url, defaults, options?)` | Form helper using Svelte 5 runes. Returns `{ data, post, put, patch, delete, pending, errors, error, hasChanges, wasSuccessful, recentlySuccessful, reset, clearErrors, clearError }`.                                                               |
+| `useIslandForm(defaults)`          | Form helper for island components where the action URL is inferred from the current island request. Returns the same form state and submit helpers as `useForm()`.                                                                                   |
+| `action(url, options?)`            | Awaitable one-shot page action helper. Uses `POST` by default and accepts `{ data, method, params }`, where `method` can be `"PUT"`, `"PATCH"`, or `"DELETE"`. Returns an `ActionResult`.                                                            |
 | `useShared()`                      | Returns shared data injected by middleware via `c.set("shared", {...})`.                                                                                                                                                                             |
 | `useRouter()`                      | Returns the Void Router with current route state (`url`, `path`, `query`, `params`) and navigation methods: `visit`, `refresh`, awaitable `prefetch`, `flush`, `flushAll`.                                                                           |
 | `useParams()`                      | Returns dynamic route params for the page currently being rendered.                                                                                                                                                                                  |
@@ -879,6 +1034,10 @@ function voidSolid(options?: VoidSolidOptions): Plugin[];
 interface VoidSolidOptions {
   solid?: SolidPluginOptions; // passed through to vite-plugin-solid
   viewTransitions?: boolean; // enable View Transitions API
+  prefetch?: {
+    hoverDelay?: number;
+    cacheFor?: number | string | [string, string];
+  };
 }
 ```
 
@@ -890,6 +1049,8 @@ Imported from `"@void/solid"`.
 | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `Link`                             | Solid component for SPA navigation. Renders `<a>` for GET, `<button>` for non-GET methods. Props: `href`, `method`, `data`, `prefetch`, `cacheFor`, `preserveScroll`, `preserveState`, `replace`, `reloadDocument`, `viewTransition`, `onNavigate`. |
 | `useForm(url, defaults, options?)` | Form helper using Solid stores. Returns `{ data, setData, post, put, patch, delete, pending, errors, error, hasChanges, wasSuccessful, recentlySuccessful, reset, clearErrors, clearError }`.                                                       |
+| `useIslandForm(defaults)`          | Form helper for island components where the action URL is inferred from the current island request. Returns the same form state and submit helpers as `useForm()`.                                                                                  |
+| `action(url, options?)`            | Awaitable one-shot page action helper. Uses `POST` by default and accepts `{ data, method, params }`, where `method` can be `"PUT"`, `"PATCH"`, or `"DELETE"`. Returns an `ActionResult`.                                                           |
 | `useShared()`                      | Returns shared data injected by middleware via `c.set("shared", {...})`.                                                                                                                                                                            |
 | `useRouter()`                      | Returns the Void Router with current route state (`url`, `path`, `query`, `params`) and navigation methods: `visit`, `refresh`, awaitable `prefetch`, `flush`, `flushAll`.                                                                          |
 | `useParams()`                      | Returns dynamic route params for the page currently being rendered.                                                                                                                                                                                 |
@@ -897,11 +1058,35 @@ Imported from `"@void/solid"`.
 
 Solid `Link` GET `data` is merged into the rendered `href` query string. Primitive values are serialized with `String(value)`, arrays become repeated keys, `null` and `undefined` are omitted, and nested objects throw. `prefetch` and `reloadDocument` are GET-only and throw for mutation links.
 
-## Subpath Exports
+## Markdown Package
+
+The optional `@void/md` package adds Markdown pages to Pages Routing. Install it alongside a Pages adapter and add `voidMarkdown()` to your Vite plugins.
+
+```ts
+import { voidMarkdown } from '@void/md/plugin';
+
+export default defineConfig({
+  plugins: [voidPlugin(), voidReact(), voidMarkdown()],
+});
+```
+
+| Import path                  | Contents                                                                                 |
+| ---------------------------- | ---------------------------------------------------------------------------------------- |
+| `@void/md/plugin`            | `voidMarkdown(options?)`, `MarkdownOptions`, `MdPage`                                    |
+| `@void/md`                   | `useFrontmatter()`, `FrontmatterContext`, `setFrontmatter()`, `MdPage`                   |
+| `@void/md/pages`             | Generated metadata for Markdown pages, used for navigation, sidebars, and search indexes |
+| `@void/md/theme.css`         | Full Markdown theme styles                                                               |
+| `@void/md/theme-content.css` | Content-only Markdown styles for apps that provide their own shell/layout                |
+
+See [Markdown Pages](../guide/pages-routing/markdown.md) for setup and framework-specific examples.
+
+## User-Facing Imports
+
+This table lists app-facing imports. Exported implementation subpaths such as `void/pages*`, `void/runtime/*`, and `void/remote*` are used by adapters, generated entries, or internal runtime wiring and are not documented as application APIs.
 
 | Import path            | Contents                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
 | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `void`                 | `voidPlugin` named export + all handler/type re-exports                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| `void`                 | `voidPlugin`, handler/type re-exports, `defer`, `Deferred`, `DeferredState`, `InferProps`, `HeadDescriptor`                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `void/handler`         | `defineHandler`, `defineMiddleware`, `defineScheduled`, `defineQueue`, `defineRender`, `defineHead`, types                                                                                                                                                                                                                                                                                                                                                                                                               |
 | `void/auth`            | `defineAuth`, `getUser`, `getSession`, `requireAuth`, `AuthUser`, `AuthSession`, `AuthState`                                                                                                                                                                                                                                                                                                                                                                                                                             |
 | `void/client`          | `fetch`, `fetchStream`, `FetchError`, `auth`, `createAuthClient`, `AuthUser`, `AuthSession`, `AuthState`                                                                                                                                                                                                                                                                                                                                                                                                                 |
@@ -917,9 +1102,15 @@ Solid `Link` GET `data` is merged into the rendered `href` query string. Primiti
 | `void/drizzle-arktype` | Re-exports [`drizzle-arktype`](https://orm.drizzle.team/docs/arktype) for schema-derived ArkType validators for Drizzle tables                                                                                                                                                                                                                                                                                                                                                                                           |
 | `void/schema-d1`       | Re-exports [`drizzle-orm/sqlite-core`](https://orm.drizzle.team/docs/column-types/sqlite) for D1 table and column builders                                                                                                                                                                                                                                                                                                                                                                                               |
 | `void/schema-pg`       | Re-exports [`drizzle-orm/pg-core`](https://orm.drizzle.team/docs/column-types/pg) for PostgreSQL table and column builders                                                                                                                                                                                                                                                                                                                                                                                               |
-| `void/db`              | `db` ([Drizzle D1](https://orm.drizzle.team/docs/get-started/d1-new) instance), `createDb`, query operators (`eq`, `and`, `or`, `desc`, `like`, `inArray`, etc.)                                                                                                                                                                                                                                                                                                                                                         |
+| `void/db`              | `db` (Drizzle D1 or PostgreSQL instance for the active dialect), `createDb`, query operators (`eq`, `and`, `or`, `desc`, `like`, `inArray`, etc.)                                                                                                                                                                                                                                                                                                                                                                        |
 | `void/seed`            | `defineSeed`, `SeedContext`, `SeedFn` for programmatic `void db seed` modules                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `void/kv`              | `kv`, `createKV`, typed KV client/map types                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| `void/storage`         | `storage`, `createStorage` for the inferred R2 binding or a specific `R2Bucket`                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| `void/ai`              | `ai`, `VoidAi`, model input and response types                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| `void/isr`             | `revalidate(options)` for on-demand ISR cache invalidation                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `void/log`             | `logger` structured logging helper                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | `void/routes`          | `RouteMap` and `WebSocketRouteMap` stubs (types only)                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
 | `void/queues`          | `queues` proxy for sending messages to typed queues                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
 | `void/sandbox`         | `getSandbox`, `sandbox`, `Sandbox`, and sandbox option types from the Cloudflare Sandbox SDK. `getSandbox(id)` resolves to the same Durable Object instance for a given `id` across all deploys and rollbacks. DO-level storage (`ctx.storage`) is durable; the container filesystem, processes, and exposed ports are tied to a single container lifetime and are lost on idle (`sleepAfter`, default `10m`), crash, or platform restart. See [Sandboxes › State persistence](../guide/sandboxes.md#state-persistence). |
-| `void/env`             | Global Cloudflare env types (types only)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `void/env`             | `defineEnv`, `env`, schema helpers (`string`, `number`, `boolean`, `url`, `email`, `oneOf`, `json`), and global Cloudflare env types                                                                                                                                                                                                                                                                                                                                                                                     |
+| `void/sveltekit`       | SvelteKit integration helpers: `withVoidTSConfig()` and `mergeVoidSvelteKitTsconfig()`                                                                                                                                                                                                                                                                                                                                                                                                                                   |

package/skills/void/docs/reference/cli.md

@@ -16,11 +16,14 @@ Use this page as a command reference. If you are setting up a project for the fi
 | `void prepare`                    | Generate `.void` artifacts without starting Vite |
 | `void gen model <name> [cols...]` | Scaffold migration + CRUD routes                 |
 | `void gen route <path>`           | Create an API route                              |
+| `void db push`                    | Apply schema directly without migration files    |
+| `void db generate`                | Generate SQL migrations from schema changes      |
 | `void db status`                  | Show local/remote migration status               |
 | `void db reset`                   | Drop and re-apply all migrations                 |
 | `void db seed`                    | Reset + seed local database                      |
 | `void db studio`                  | Open Drizzle Studio for local database           |
 | `void secret put <name=value>`    | Set a production secret                          |
+| `void secret list`                | List production secrets                          |
 | `void secret sync .env.local`     | Bulk upload secrets from dotenv file             |
 | `void env check [--remote]`       | Validate env.ts schema                           |
 | `void env types`                  | Regenerate .void/env.d.ts from env.ts            |
@@ -29,7 +32,9 @@ Use this page as a command reference. If you are setting up a project for the fi
 | `void project link`               | Link directory to a project                      |
 | `void project logs`               | Show runtime logs from deployed project          |
 | `void project rollback`           | Roll back to a previous deployment               |
+| `void project cancel`             | Cancel an active deployment                      |
 | `void project purge-cache`        | Purge all cached pages                           |
+| `void mcp`                        | Start the Void MCP server                        |
 | `void init`                       | Setup wizard for new or existing projects        |
 
 ## Binary Invocation
@@ -66,7 +71,9 @@ void init [--tsconfig] [--github] [--agents]
 
 Setup wizard for Void projects (new or existing).
 
-If run in a scaffoldable empty directory, `void init` scaffolds a Pages starter. If a single Pages adapter is already installed, it reuses that framework; otherwise it asks which framework to scaffold (React, Vue, Svelte, or Solid). It then asks which starter you want: D1, PostgreSQL, or Static Pages. The D1 and PostgreSQL starters write a framework-specific `vite.config.ts`, a `pages/` home page plus `.server.ts` loader, `db/schema.ts`, `db/seed.ts`, a generated initial migration under `db/migrations/`, and `routes/api/hello.ts`. The Static Pages starter writes just the framework-specific `vite.config.ts` and a `pages/` home page so you can add server features later.
+If run in a scaffoldable empty directory, `void init` scaffolds a Pages starter. It asks which scaffold toolchain to use, with Vite+ as the default top option and plain Vite as the alternative. If a single Pages adapter is already installed, it reuses that framework; otherwise it asks which framework to scaffold (React, Vue, Svelte, or Solid). It then asks which starter you want: D1, PostgreSQL, or Static Pages. The D1 and PostgreSQL starters write a framework-specific `vite.config.ts`, a `pages/` home page plus `.server.ts` loader, `db/schema.ts`, `db/seed.ts`, a generated initial migration under `db/migrations/`, and `routes/api/hello.ts`. The Static Pages starter writes just the framework-specific `vite.config.ts` and a `pages/` home page so you can add server features later. Vite+ starters add `vite-plus` and use `vp dev`, `vp build`, and `vp preview` scripts.
+
+If run in a non-empty folder that does not look like an app yet, such as a parent `Projects/` folder with subdirectories but no `package.json`, `void init` asks whether to create a new subfolder or continue in the current folder. Creating a subfolder is the default selection.
 
 If run in an existing project, `void init` configures the project in place: it ensures `void` and `vite` are declared, adds missing `dev` (`vite`) and `build` (`vite build`) scripts without overwriting existing scripts, and creates or patches `vite.config.*` with `voidPlugin()` when the config shape is safe to edit. If the Vite config is too dynamic to patch confidently, it prints the manual snippet instead of rewriting it.
 
@@ -182,6 +189,17 @@ Roll back to a previous deployment. Traffic instantly switches to the target dep
 
 Only **retained** deployments can be rolled back to. The number of retained deployments depends on your plan (free: 1, solo: 5, pro: 25, unlimited for sponsored/custom).
 
+### `void project cancel [deployId]`
+
+```
+void project cancel [deployId]
+```
+
+Cancel an active deployment.
+
+- If `[deployId]` is omitted, shows an interactive select menu of active deployments for the linked project
+- If `[deployId]` is provided, cancels that deployment directly
+
 ### `void project delete [name]`
 
 Permanently delete a project and all its resources (databases, KV namespaces, R2 buckets, deployments). Requires typing the project slug to confirm.
@@ -232,6 +250,18 @@ That fallback is mainly for projects that skipped Void project setup during `voi
 
 ## Database
 
+### `void db push`
+
+Apply your Drizzle schema directly to the development database without creating migration files. For D1 projects, this updates the local D1 database used by dev. For PostgreSQL projects, this uses `DATABASE_URL` from `.env.local`.
+
+Use this for quick schema iteration while prototyping. Before deploying, generate and review migration files with `void db generate`.
+
+### `void db generate`
+
+Generate SQL migration files from schema changes.
+
+The command compares your current `db/schema.ts` or `db/schema/` modules against the last generated Drizzle snapshot and writes new migration artifacts under `db/migrations/`. Review and commit the generated files before deploying.
+
 ### `void db status`
 
 Show migration status. Displays which migrations are applied or pending locally. When logged in and linked to a project, also shows remote status.
@@ -416,6 +446,14 @@ void gen queue emails
 
 ## Secrets
 
+### `void secret list`
+
+```
+void secret list [--project <name>]
+```
+
+List the production secrets configured for the project. Secret values are never printed.
+
 ### `void secret put`
 
 ```
@@ -537,10 +575,12 @@ List all custom domains and their status (active/pending).
 ### `void domain status`
 
 ```
-void domain status <hostname> [--project <name>]
+void domain status <hostname> [--project <name>] [--verbose]
 ```
 
-Check verification and SSL status for a specific domain. Shows hostname, status, SSL status, and any verification errors.
+Check verification and SSL status for a specific domain. Prints a rolled-up state (`awaiting_dns`, `verifying_dns`, `issuing_cert`, `deploying_cert`, `awaiting_deployment`, `active`, `error`, or `pending`) with a one-line diagnostic explaining what Cloudflare is doing and any user action required. When DNS records are still pending, the command also prints the exact TXT records to add at your DNS provider.
+
+Pass `--verbose` to additionally print the raw multi-line status breakdown (DB status, SSL status, ownership state, verification errors) underneath the rollup.
 
 Project resolution for domain commands follows the same order as deploy (`--project`, `VOID_PROJECT`, linked project).
 
@@ -556,9 +596,17 @@ Runs all agent setup steps:
 
 If no agent is detected, `void init --agents` asks you to choose from Claude Code, Cursor, Codex, Gemini CLI, or Generic.
 
+### `void mcp`
+
+```
+void mcp
+```
+
+Start the Void MCP server over stdio for supported coding agents.
+
 ## Environment variables
 
-| Variable       | Purpose                                                      | Default |
-| -------------- | ------------------------------------------------------------ | ------- |
-| `VOID_TOKEN`   | Auth token override instead of saved config                  | none    |
-| `VOID_PROJECT` | Default project slug for deploy, secret, and delete commands | none    |
+| Variable       | Purpose                                                                   | Default |
+| -------------- | ------------------------------------------------------------------------- | ------- |
+| `VOID_TOKEN`   | Auth token override instead of saved config                               | none    |
+| `VOID_PROJECT` | Default project slug for deploy, secret, domain, and cache purge commands | none    |

package/skills/void/docs/reference/config.md

@@ -13,6 +13,7 @@ Project-level configuration lives in a `void.json` file at the project root. Mos
 ```json
 {
   "$schema": "./node_modules/void/schema.json",
+  "sourceDir": "src",
   "target": "cloudflare",
   "auth": {
     "providers": ["email", "github", "google"]
@@ -36,10 +37,24 @@ Project-level configuration lives in a `void.json` file at the project root. Mos
 }
 ```
 
-Add the `$schema` field for autocomplete and validation in your editor.
+Add the `$schema` field for autocomplete and validation in your editor. The schema ships with the `void` package at `node_modules/void/schema.json` and is also exposed as the `void/schema.json` package subpath.
 
 ## Fields
 
+### `sourceDir`
+
+Directory containing Void source conventions, relative to the project root.
+
+When omitted, Void uses the existing project-root conventions: `pages/`, `routes/`, `middleware/`, `crons/`, `queues/`, `db/`, `auth.ts`, and `env.ts`.
+
+When set, those conventions move under the configured directory:
+
+```json
+{ "sourceDir": "src" }
+```
+
+With that config, Void reads `src/pages`, `src/routes`, `src/db/schema.ts`, `src/db/migrations`, `src/auth.ts`, and `src/env.ts`. Project files such as `void.json`, `vite.config.ts`, `package.json`, `tsconfig.json`, `wrangler.json`, `public/`, and `.env*` stay at the project root. Void does not scan both locations; if source conventions exist in both places during dev/build, remove one copy so the active source tree is unambiguous.
+
 ### `auth`
 
 High-level Better Auth configuration.
@@ -222,7 +237,9 @@ Deploy target runtime. Defaults to `"cloudflare"`.
 | `"bun"`        | Bun, using `Bun.serve()`                                  |
 | `"deno"`       | Deno, using `Deno.serve()`                                |
 
-Non-CF targets disable CF bindings (`void/db`, `void/kv`, `void/auth`, `void/storage`, `void/ai`, `void/sandbox`, `void/env`, `void/ws`). Importing any of these with a non-CF target produces a compile-time error. File-based routing, middleware, and `void/client` all work normally.
+Non-CF targets disable CF binding imports (`void/db`, `void/kv`, `void/auth`, `void/storage`, `void/ai`, `void/sandbox`, `void/env`). Importing any of these with a non-CF target produces a compile-time error. File-based routing, middleware, and `void/client` all work normally.
+
+Void-managed WebSocket route files (`*.ws.ts`) are Cloudflare-only because they compile to Durable Objects. The `void/ws` subpath itself is not blocked on non-CF targets so client-side `connect()` code can still be bundled where a browser-like `WebSocket` runtime is available.
 
 ```json
 { "target": "node" }
@@ -236,23 +253,29 @@ Curated Cloudflare Workers configuration. Cloudflare-targeted apps require an ex
 | --------------------- | ---------- | -------------------------------------- |
 | `compatibility_date`  | `string`   | Cloudflare Workers compatibility date  |
 | `compatibility_flags` | `string[]` | Cloudflare Workers compatibility flags |
+| `vars`                | `object`   | Plain-text worker variables            |
 
 ```json
 {
   "worker": {
     "compatibility_date": "2025-12-01",
-    "compatibility_flags": ["nodejs_compat"]
+    "compatibility_flags": ["nodejs_compat"],
+    "vars": {
+      "PUBLIC_API_BASE": "https://api.example.com"
+    }
   }
 }
 ```
 
+`worker.vars` values must be strings. They are merged into Worker bindings before `.env` files are loaded, so project `.env` values override `worker.vars` for local dev/build. Do not put secrets here; use `env.ts` plus `void secret put` for production secrets.
+
 ### `routing`
 
 Routing and edge configuration for headers, redirects, rewrites, and caching.
 
 #### `routing.headers`
 
-Custom response headers for static assets. Keys are URL patterns, values are arrays of `"Name: value"` strings. See [Custom Headers](../guide/edge/headers) for details.
+Custom response headers for dispatch-worker responses. Keys are URL patterns, values are arrays of `"Name: value"` strings. See [Custom Headers](../guide/edge/headers) for details.
 
 ```json
 {

package/skills/void/docs/reference/resource-inference.md

@@ -26,7 +26,7 @@ This runs once before plugins initialize, so the results are available to config
 | `AI`      | `Ai`                              | `import { ai } from "void/ai"`                                            | `env.AI` or `c.env.AI`           |
 | `SANDBOX` | `DurableObjectNamespace<Sandbox>` | `import { getSandbox } from "void/sandbox"`                               | `env.SANDBOX` or `c.env.SANDBOX` |
 | Auth      | none                              | `import { ... } from "void/auth"` or `import { auth } from "void/client"` | none                             |
-| `QUEUE_*` | `Queue`                           | `import { ... } from "void/queue"`                                        | `env.QUEUE_*`                    |
+| `QUEUE_*` | `Queue`                           | `import { queues } from "void/queues"`                                    | `env.QUEUE_*`                    |
 
 Auth detection also triggers when importing the `auth` specifier from `void/client` (but not when importing only `fetch`).