Compose. Verify. Ship.
Compose a full-stack TypeScript stack and get a cutting-edge, verified project made for AI coding agents, with type safety, lint, and tests built in.
English · 简体中文
vibestart-launch-en.mp4
Pick each layer in the web studio and copy the command it builds, or answer the prompts in your terminal:
npx vibestart-cliPaste this command, along with what you want to build, into Claude Code, Codex, Cursor, or any coding agent:
npx skills add VinkyDev/vibestart --skill vibestartThe agent installs the vibestart skill, chooses the stack, and creates the project. See the Agent Skills guide.
Inside a generated project, Vite+ (vp) runs development and checks, and the CLI keeps the template up to date:
vp run dev # Start local development
vp run ready # Check types, lint, unused code, tests, and build
npx vibestart-cli doctor # Inspect project state and available template updates
npx vibestart-cli upgrade # Three-way merge template updates while keeping your codeFull details: Why vibestart.
With a coding agent, the hard part of an application is rarely the first day. It is the thirtieth: features pile up, the structure erodes, and each fix introduces another bug. VibeStart gives the agent, and you, a better starting point: best practices for a current, carefully chosen stack, and a codebase built so that an agent writes good code in it.
- Good code begets good code. An agent imitates the code around it, follows written rules, and corrects itself from errors. Every project ships a consistent codebase, an
AGENTS.mdthat says where and how each change is made, and checks (types, lint, tests) that report a mistake within seconds.vp run readyruns them all, fastest first. - A current stack, kept current. Only technologies that are the current standard or clearly becoming it: TypeScript 7, React 19 with the React Compiler, Drizzle ORM 1.0, Oxlint and Oxfmt, and Vite+ as one toolchain. Open source, no vendor lock-in, one library per capability.
- Composed, not copied. Each technology is an integration with its own files, dependencies, and constraints, and the project is composed from the integrations you choose. A combination that cannot work is refused with the reason and the smallest change that fixes it.
- Every combination is verified. Before each release, every supported combination is covered: each file
vp run readyreads, and every three of its choices together, have been installed, type-checked, linted, tested, tested in a browser, and built in a combination that CI ran. The passes are recorded with fingerprints on theverificationbranch, and the CLI shows a representative pass for your project when it creates it. - TypeScript across the stack. One language from database to button, with types that travel from the schema through the API to the page and no code generation step.
- Tests that earn their place. End-to-end tests for whole workflows, integration tests for every API operation against a real database, and unit tests only for logic with real branches.
- Maintained after creation.
upgradecompares the original template, your project, and the new template, and previews the result before writing anything. Template files take the update; your application code stays as you wrote it.
VibeStart does not host your application, does not migrate production data, and does not hide the code. A generated project is an ordinary repository with no runtime dependency on VibeStart.
| Layer | Choices |
|---|---|
| Mode | Standard (default) or Effect (--mode effect) |
| App | React SPA (TanStack Router), TanStack Start, Next.js |
| Desktop | Electron |
| Mobile | Expo (React Native), iOS and Android |
| Backend | Hono, Effect HTTP, or the framework's own server |
| API | oRPC, Effect RPC, OpenAPI, or none |
| Database | PostgreSQL, MySQL, SQLite, MongoDB, or none |
| ORM | Drizzle, or Prisma on PostgreSQL and MySQL; Mongoose on MongoDB |
| Auth | Better Auth |
| Deployment | Docker, Void on Cloudflare Workers (preview) |
| UI | shadcn (Base UI) and Tailwind 4 |
| Unit & integration tests | Vitest |
| End-to-end tests | Playwright or TesterArmy e2e |
| Toolchain | Vite+, Oxlint, Knip, AGENTS.md |
Standard mode is the default and offers the widest range of stacks. Pass --mode effect (or switch in the studio) for an end-to-end Effect stack with typed errors and scoped service layers.
- vibestart.net/docs: quick start, choosing a stack, the CLI reference, testing, and concepts
- Architecture: the model, the resolver, integrations, verification, and project maintenance
- AGENTS.md: the rules for code in this repository and in every generated project
Contributions are welcome. Read CONTRIBUTING.md for setup, the checks to run, and how templates are verified.
MIT, copyright VinkyDev and contributors. Third-party materials retain their respective licenses.