Skip to content
VinkyDevPublic

About

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. | 自由组合全栈 TypeScript 技术栈,得到一个前沿、经过验证、为 AI 编码智能体打造的项目,内置类型安全、lint 与测试。

Topics

Resources

Contributing

Stars

297 stars

Watchers

2 watching

Forks

Latest commit

 

History

132 Commits

Folders and files

Repository files navigation

VibeStart

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.

npm skills.sh CI License: MIT

English · 简体中文

vibestart-launch-en.mp4

Quick start

Compose it yourself

Pick each layer in the web studio and copy the command it builds, or answer the prompts in your terminal:

npx vibestart-cli

Hand it to an AI agent

Paste this command, along with what you want to build, into Claude Code, Codex, Cursor, or any coding agent:

npx skills add VinkyDev/vibestart --skill vibestart

The agent installs the vibestart skill, chooses the stack, and creates the project. See the Agent Skills guide.

Develop and maintain

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 code

Why VibeStart

Full 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.md that says where and how each change is made, and checks (types, lint, tests) that report a mistake within seconds. vp run ready runs 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 ready reads, 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 the verification branch, 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. upgrade compares 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.

Supported stacks

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.

Documentation

  • 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

Contributing

Contributions are welcome. Read CONTRIBUTING.md for setup, the checks to run, and how templates are verified.

License

MIT, copyright VinkyDev and contributors. Third-party materials retain their respective licenses.

Star History

Star History Chart

About

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. | 自由组合全栈 TypeScript 技术栈,得到一个前沿、经过验证、为 AI 编码智能体打造的项目,内置类型安全、lint 与测试。

Topics

Resources

Contributing

Stars

297 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages