feat(cli): setup neon

docs/implementation-docs/2026-03-26-cedarjs-project-overview.md

@@ -175,7 +175,7 @@ cedar
 │   └── render│serverless    │   └── secret│package│model
 ├── destroy (d) [mirror]     ├── setup
 ├── exec [script]            │   ├── auth <provider>
-├── experimental             │   ├── vite│docker│i18n│jobs
+├── experimental             │   ├── vite│docker│i18n│jobs|neon
 │   ├── rsc│streaming-ssr    │   ├── deploy│ui│cache│realtime
 │   ├── live-queries         │   └── mailer│middleware│server-file
 │   └── opentelemetry        │
@@ -188,10 +188,10 @@ cedar new → yarn create cedar-app (standalone)
 ## SCAFFOLD OUTPUT (`cedar generate scaffold Post`)
 
 ```
-api/src/graphql/posts.sdl.ts              ← schema only (types, queries, mutations, inputs)
-api/src/services/posts/posts.ts           ← resolver implementations (typed against auto-generated types/graphql)
-api/src/services/posts/posts.test.ts      ← tests
-api/src/services/posts/posts.scenarios.ts ← test fixtures
+api/src/graphql/posts.sdl.ts              <- schema only (types, queries, mutations, inputs)
+api/src/services/posts/posts.ts           <- resolver implementations (typed against auto-generated types/graphql)
+api/src/services/posts/posts.test.ts      <- tests
+api/src/services/posts/posts.scenarios.ts <- test fixtures
 
 web/src/components/Post/
   PostForm.tsx        ← form (uses @cedarjs/forms typed fields)

packages/cli/src/commands/setup.ts

@@ -22,6 +22,7 @@ import * as setupJobs from './setup/jobs/jobs.js'
 import * as setupMailer from './setup/mailer/mailer.js'
 import * as setupMiddleware from './setup/middleware/middleware.js'
 import * as setupMonitoring from './setup/monitoring/monitoring.js'
+import * as setupNeon from './setup/neon/neon.js'
 // @ts-expect-error - Types not available for JS files
 import * as setupPackage from './setup/package/package.js'
 // @ts-expect-error - Types not available for JS files
@@ -55,6 +56,7 @@ export const builder = (yargs: Argv) =>
     .command(setupMiddleware)
     // @ts-expect-error - Yargs TS types aren't very good
     .command(setupMonitoring)
+    .command(setupNeon)
     .command(setupPackage)
     .command(setupRealtime)
     .command(setupServerFile)

packages/cli/src/commands/setup/neon/neon.ts

@@ -0,0 +1,30 @@
+import type { Argv } from 'yargs'
+
+import { recordTelemetryAttributes } from '@cedarjs/cli-helpers'
+
+export const command = 'neon'
+export const description =
+  'Provision a Neon Postgres database and configure your project'
+
+export function builder(yargs: Argv) {
+  return yargs.option('force', {
+    alias: 'f',
+    default: false,
+    description: 'Overwrite existing DATABASE_URL in .env',
+    type: 'boolean',
+  })
+}
+
+export interface Args {
+  force: boolean
+}
+
+export async function handler({ force }: Args) {
+  recordTelemetryAttributes({
+    command: 'setup neon',
+    force,
+  })
+
+  const { handler } = await import('./neonHandler.js')
+  return handler({ force })
+}