First Block to production

Recommended rollout if you are new to the platform.

Step 1: Choose import path

• Use Install with CLI if you already have an app.
• Use Download as App if you want full scaffolding and setup defaults.
• Use Hono or Nitro export if the frontend and Block API should run as separate services.

Step 2: Get implementation context fast

Use Copy for a coding agent from the Block viewer and paste the Next.js or Hono target into your AI coding tool.

Ask the AI for focused changes:

• adapt model/provider
• customize tools and schemas
• keep external API surface unchanged

Step 3: Configure runtime

Set required environment variables and external service credentials before testing.

For Hono exports, use Node.js >=24, configure HOST, PORT, and CORS_ORIGINS, then connect the frontend to the route listed in the generated README.

Step 4: Validate locally

Copypnpm lint
pnpm typecheck
pnpm dev

Verify:

• route loads
• streaming/tool calls succeed
• error states render correctly

Step 5: Production hardening

• add rate limits where applicable
• add monitoring/logging
• verify auth boundaries
• test failure fallbacks for external APIs

For an exported Hono service, complete the production deployment checklist.

Step 6: Ship incrementally

• deploy behind an internal feature flag
• gather traces and error rates
• then roll out broadly