Skip to content

Clarify Vercel and local setup paths - #100

Merged
fmhall merged 2 commits into
mainfrom
mason/clarify-vercel-local-setup
Sep 1, 2026
Merged

Clarify Vercel and local setup paths#100
fmhall merged 2 commits into
mainfrom
mason/clarify-vercel-local-setup

Conversation

@fmhall

@fmhall fmhall commented Sep 1, 2026

Copy link
Copy Markdown
Member

Summary

  • recommend the guided Deploy with Vercel flow to setup agents and explain which services and credentials it provisions automatically
  • replace the ambiguous local snippet with explicit Node, pnpm, Docker, Kernel, AI Gateway, and .env.local requirements
  • link manual users to Kernel API key creation and document vercel integration add kernel --plan FREE for an existing linked Vercel project
  • load .env.local before the development supervisor starts and reject a missing Kernel key before Docker or migrations
  • cover both the early failure and the existing present-key Compose lifecycle

Validation

  • pnpm test:app tests/local-development.test.ts — 7 tests passed
  • KERNEL_API_KEY= pnpm dev — exited before Docker with the expected manual/Vercel guidance
  • pnpm check — 60 test files and 254 tests passed, plus lint, types, formatting, Knip, and boundaries
  • KERNEL_API_KEY=build-validation-placeholder pnpm build — passed without making an external Kernel request

Review notes

The Vercel path remains the recommended deployment: its Kernel Marketplace integration, Neon resource, private Blob store, Linq connector, and AI Gateway access are provisioned through the guided flow. Fully manual setup links to kernel.sh; an existing linked Vercel project can provision and connect the free Kernel Developer plan through the current Marketplace CLI. The explicit credentials in .env.example and the preflight apply to manual local development.

@fmhall
fmhall merged commit 2e3d2a7 into main Sep 1, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant