readme.md

Greenfield

Opinionated full-stack web application starter template

NOT PRODUCTION READY! NOT EVEN EXPERIMENTATION READY!

Quick start

pnpm dlx degit rakkasjs/greenfield my-project
cd my-project
git init && git checkout -b main
pnpm install
pnpm run dev

Features

• Batteries included: Start building right away, scale up as needed
• Bleeding edge stack: Use technology from the future
• API layer optional: Use useServerSideQuery and useServerSideMutation or plain HTML forms
• End-to-end static typing: Strongly typed from database to client
• Lightning fast development server: Get immediate feedback on changes
• Complete code quality tooling: Type checking, linting, testing, commit hooks all set up

Stack

• Rakkas: Web application framework
  • React: User interface library
  • Vite: Development server and build tool
• Prisma: Type-safe ORM
  • SQLite: SQL database
• Mantine: UI component library
  • Emotion: CSS-in-JS library

Code quality tools

• TypeScript: Strongly typed JavaScript superset
• ESLint: JavaScript/TypeScript linter
• Husky: Git hooks manager
• lint-staged: Check/format staged files before commit
• Prettier: Opinionated code formatter
• Vitest: Testing framework

Missing pieces

• End-to-end testing (Cypress? Playwright? Vitest + Puppeteer?)
• Background jobs (BullMQ? Bee Queue?)
• Web sockets and realtime
• File uploads
• Email (Node Mailer?)