| 1 | > Runtime acceptance is pending the Neon deployment and browser checks; this example is not yet verified on Neon. |
| 2 | |
| 3 | # Neon Website: Nuxt |
| 4 | |
| 5 | Deploys a real Nuxt application with `Neon.Website.Nuxt`. |
| 6 | |
| 7 | A Nuxt SSR page reads `GREETING`, hydrates a Vue counter, and calls a Nitro `/api/hello` endpoint. `/about` is prerendered. |
| 8 | |
| 9 | Native dev and desktop/mobile interactions have passed. With a proper workspace dependency installation, the production build, safe artifact staging, and Node 24 Fetch page/asset/HEAD checks pass. Live deployment and updates remain unverified. |
| 10 | |
| 11 | ## Infrastructure |
| 12 | |
| 13 | `alchemy.run.ts` uses `Neon.providers()` and `Alchemy.localState()`. |
| 14 | The helper uses the application root by default. Live deployments without explicit |
| 15 | scope own a Neon Project in Ohio (`aws-us-east-2`), including its normal default |
| 16 | database, and a Node 24 Function. The app does not query that database. |
| 17 | No Docker daemon, container registry, or other cloud provider is used. |
| 18 | Pass an existing `project` or `branch` to reuse it without transferring ownership. |
| 19 | |
| 20 | The workspace supplies `alchemy` and `@alchemy.run/frontend-frameworks` through |
| 21 | `workspace:*` dependencies. `@vercel/nft` is installed for Neon artifact tracing. |
| 22 | Install dependencies from the repository root before |
| 23 | running commands in this directory. Authenticate Neon using the Alchemy profile |
| 24 | you intend to deploy with. |
| 25 | |
| 26 | ## Deploy |
| 27 | |
| 28 | ```sh |
| 29 | bun run deploy --profile testing |
| 30 | ``` |
| 31 | |
| 32 | The stack returns `url`. Framework configuration, application sources, and public |
| 33 | assets are included in this example; the Website helper owns the deployment adapter. |
| 34 | |
| 35 | ## Develop |
| 36 | |
| 37 | ```sh |
| 38 | bun run dev |
| 39 | ``` |
| 40 | |
| 41 | This runs the native framework dev server without creating an implicit Website-owned |
| 42 | Neon backend. Explicit backend resources remain live resources. Apply |
| 43 | `Alchemy.remote()` to the Website Effect to deploy a real Function during dev. |
| 44 | Cloud-only `function` and `domain` outputs are absent locally. |
| 45 | |
| 46 | ## Verify |
| 47 | |
| 48 | ```sh |
| 49 | ALCHEMY_PROFILE=testing bun test test/integ.test.ts |
| 50 | ``` |
| 51 | |
| 52 | The integration suite destroys previous stack state, deploys the actual app, |
| 53 | requests its page, dynamic endpoint, verifies the static JSON asset, and destroys the stack. |
| 54 | Set `NO_DESTROY=1` only when intentionally keeping the deployment for inspection. |
| 55 | |
| 56 | For browser validation, open the returned URL. Click **count: 0**; it becomes **count: 1**. Click **Load greeting** and check that the greeting appears below the button. |
| 57 | Every app also serves `/example.json` with a framework label and greeting. |
| 58 | |
| 59 | ## Destroy |
| 60 | |
| 61 | ```sh |
| 62 | bun run destroy --profile testing |
| 63 | ``` |
| 64 | |
| 65 | ## Packaging and security |
| 66 | |
| 67 | The Function receives a deterministic ZIP with a root Fetch `index.mjs`; it is not a |
| 68 | listening server or S3 website. Runtime dependencies are traced with `@vercel/nft`. |
| 69 | Only traced pnpm dependency files are materialized, with Node 24 resolution hooks |
| 70 | preserving canonical package identity. Native addons require Linux/Node 24 validation |
| 71 | and are currently rejected. `.env` files, credential files, and source maps are excluded. |
| 72 | |
| 73 | Framework public environment prefixes are intentionally browser-visible. Keep secrets |
| 74 | out of those variables; `Redacted` protects infrastructure output, not arbitrary |
| 75 | framework build-time substitution. Never put `NEON_API_KEY` in Website `env`. |
| 76 | |
| 77 | Optional `domain` registers a custom hostname and returns `domain.cnameTarget`. |
| 78 | Publish a DNS-only CNAME and verify HTTPS independently; registration is not proof |
| 79 | of certificate readiness. Functions have public URLs, so authenticate private |
| 80 | application routes in the handler. |