gem-hunter
Language: TypeScript
Production-ready Express.js/TypeScript framework with auto-generated OpenAPI, Artisan-style CLI, plugin system, JWT/sessions, BullMQ, React Email, Socket.io, Django-style admin, multi-provider storage/cache/email, Zod validation
Developer‑first backend toolkit
Simple for beginners, productive for experts — and structured so tools (including AI agents) can follow it without guesswork.
Predictable architecture. Type‑safe patterns. Plugin‑based. Production‑ready.
Quick Start • Features • CLI • Architecture • Documentation
Before you get started, make sure you have the following installed on your machine:
Use the CLI scaffolder to create a new project with only the features you need:
# Interactive mode (recommended) npx create-tbk-app my-backend-api # Or with a preset npx create-tbk-app my-api --preset=standard # Then start developing cd my-api pnpm dev
See create-tbk-app README for all options and presets.
Visit http://localhost:3000/docs for your auto-generated API documentation.
/docs, always in sync.The project is intentionally structured so almost any AI coding agent can work reliably: predictable files, clear schemas, and consistent codegen. Use AI tools if you like—or ignore them and build normally.
The tbk command‑line tool is productivity‑focused, similar to Laravel’s Artisan. It helps you scaffold features and run common tasks quickly and consistently.
# Scaffold features fast (Artisan‑like) pnpm tbk g:module user --path /api/v1 pnpm tbk g:plugin admin pnpm tbk seed # Discover commands pnpm tbk --help pnpm tbk g:module --help
src/
├── app/ # Application setup and plugin registration
├── modules/ # Domain logic (users, products, payments)
├── plugins/ # Extensible features (auth, realtime, admin)
├── lib/ # Infrastructure clients (database, storage, email)
├── utils/ # Pure functions (JWT, passwords, pagination)
├── config/ # Type-safe environment configuration
└── routes/ # HTTP wiring with MagicRouter
Each folder has one job:
app/ boots the server and wires plugins.modules/ holds your business logic and schemas.plugins/ adds features without touching core code.lib/ connects to infra (DB, queues, email, storage).utils/ contains small, pure helpers.config/ validates environment variables.routes/ declares HTTP endpoints.Core capabilities included:
/docs# Development pnpm dev # Start with hot reload pnpm build # Compile to dist/ pnpm start # Run production build pnpm typecheck # Type checking pnpm lint # ESLint + Prettier # CLI Tools pnpm tbk g:module <name> # Generate complete module pnpm tbk g:plugin <name> # Generate plugin pnpm tbk seed # Run database seeders pnpm tbk docs:openapi # Generate OpenAPI spec pnpm tbk docs:sdk # Generate TypeScript SDK # Other Tools pnpm email:dev # Preview email templates
# Build for production pnpm build # Set production environment cp .env.production .env # Start production server pnpm start:prod
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)This project is licensed under the MIT License - see the LICENSE file for details.
Built to make backend development effortless