BaseForge

BaseForge is a TypeScript-first developer project generator.

The MVP is website-first: users configure a project, preview the generated output, and download a zip. The shared-generator CLI is published as @baseforge/create.

Supported MVP Stack

BaseForge currently generates this stack:

Area	Supported options
Framework	Next.js
Language	TypeScript
Router	App Router
Project structure	No src/ folder
Styling	Tailwind CSS
UI	none, shadcn/ui
Database	none, PostgreSQL
ORM	none, Prisma
Auth	none, Auth.js credentials scaffold
Docker	none, PostgreSQL Docker Compose
Package manager	npm, pnpm instructions/generated metadata where supported

Unsupported frameworks, languages, routers, project structures, styling systems, databases, ORMs, auth providers, Docker setups, and package managers are intentionally not available in the MVP.

Downloaded Project Usage

Generate from npm with the published CLI:

npx @baseforge/create@latest my-app
cd my-app
npm install
npm run dev

Or download a zip from the website builder.

For an npm project:

unzip my-app.zip
cd my-app
npm install
npm run dev

Before relying on the project output, run:

npm run typecheck
npm run build

For a pnpm project, use the equivalent generated instructions:

pnpm install
pnpm dev
pnpm typecheck
pnpm build

Feature Notes

PostgreSQL-backed features require DATABASE_URL before use.

Prisma projects include:

npm run db:generate
npm run db:push
npm run db:studio

Auth.js credentials output is a scaffold. Replace AUTH_SECRET, implement real user lookup, and add secure password verification before production use.

Docker PostgreSQL is local development support:

docker compose up -d
docker compose down

Roadmap

• Keep the website MVP stable first.
• Keep the existing shared-generator CLI release workflow stable.
• Add more stack options only after the core generation flow is reliable.

Limitations

• The CLI package is published as @baseforge/create.
• Only Next.js is supported.
• Only TypeScript is supported.
• Only App Router is supported.
• Generated projects do not use src/.
• Only Tailwind CSS is supported.
• Auth.js credentials output is a scaffold, not production-ready auth.
• PostgreSQL Docker Compose is for local development only.
• BaseForge does not install dependencies for generated projects.
• BaseForge does not run generated project code on the server.
• Users must configure real secrets and production environment variables.

Release Note

@baseforge/create is a public scoped npm package. Future publishes must use npm publish -w @baseforge/create --access public.