stacky-cli

Stacky

Framework-agnostic CLI scaffolding tool for backend applications

Installation • Usage • Features • Roadmap • Contributing

About The Project

Stacky is a CLI tool that scaffolds production-ready backend projects with your choice of framework, runtime, database, and authentication. It uses a plugin-based architecture following the Strategy Pattern for extreme modularity.

Why Stacky?

• Start projects in seconds, not hours
• Production-ready setup with Docker, CORS, logging, and health checks
• Mix and match frameworks, runtimes, databases, and auth providers
• Consistent project structure across different tech stacks

Built With

• Commander.js - CLI framework
• Clack - Beautiful CLI prompts
• TypeScript - Type safety

Installation

npm install -g stacky-cli

Or use directly with npx:

npx stacky-cli my-app

Usage

Interactive Mode

Simply run stacky and follow the prompts:

stacky

CLI Flags Mode

Skip the prompts with flags:

stacky my-app -f hono -r bun -d drizzle -a better-auth -i

Available Options

Flag	Description	Values
-f, --framework	Web framework	hono, express, fastify
-r, --runtime	JavaScript runtime	node, bun
-d, --database	Database ORM	prisma, drizzle
-a, --auth	Authentication	better-auth, passport
-i, --install	Auto-install dependencies	-
--no-docker	Skip Docker setup	-
--no-cors	Skip CORS middleware	-
--no-logging	Skip request logging	-
--no-health	Skip health endpoint	-

Examples

Hono + Bun + Drizzle + Better Auth:

stacky my-api -f hono -r bun -d drizzle -a better-auth -i

Express + Node (minimal):

stacky my-api -f express -r node --no-docker

Fastify + Prisma:

stacky my-api -f fastify -r node -d prisma -i

Features

Frameworks

Framework	Description
Hono	Ultra-fast, lightweight, Web Standards
Express	Classic, mature ecosystem
Fastify	High performance, schema validation

Runtimes

Runtime	Description
Node.js	Stable, widely supported
Bun	Fast, modern, batteries included

Databases

ORM	Description
Drizzle	Lightweight, SQL-like, type-safe
Prisma	Full-featured, migrations, studio

Authentication

Provider	Description
Better Auth	Modern, session-based, easy setup
Passport	Classic, 500+ strategies

Generated Project Structure

my-app/
├── src/
│   ├── index.ts        # App entry point
│   ├── db/             # Database (Drizzle)
│   │   ├── index.ts
│   │   └── schema.ts
│   └── lib/
│       └── auth.ts     # Auth config
├── prisma/             # Database (Prisma)
│   └── schema.prisma
├── .env
├── .env.example
├── .gitignore
├── .dockerignore
├── Dockerfile
├── drizzle.config.ts
├── eslint.config.js
├── package.json
├── tsconfig.json
└── README.md

Included by Default

• TypeScript - Strict mode enabled
• ESLint - ESLint 9 flat config with TypeScript support
• Docker - Production-ready Dockerfile
• Environment - .env and .env.example files
• Health Check - /health endpoint
• CORS - Cross-origin resource sharing
• Logging - Request logging middleware

Roadmap

• Core CLI with interactive prompts
• Hono, Express, Fastify frameworks
• Node.js and Bun runtimes
• Prisma and Drizzle ORMs
• Better Auth and Passport authentication
• Docker support
• ESLint configuration
• Testing setup (Vitest)
• CI/CD templates (GitHub Actions)
• More auth providers (Lucia, Auth.js)
• Redis/caching support
• OpenAPI/Swagger generation
• Monorepo support

Contributing

Contributions are welcome! Here's how:

• Fork the repository
• Create your feature branch (git checkout -b feature/amazing-feature)
• Commit your changes (git commit -m 'Add amazing feature')
• Push to the branch (git push origin feature/amazing-feature)
• Open a Pull Request

Adding a New Plugin

Plugins follow the Strategy Pattern. See existing plugins in:

• src/plugins/frameworks/ - Framework plugins
• src/plugins/databases/ - Database plugins
• src/plugins/auth/ - Auth plugins

License

Distributed under the MIT License. See LICENSE for more information.

Acknowledgments

• create-t3-app - Inspiration for interactive CLI
• Hono - Amazing web framework
• Drizzle - TypeScript ORM
• Better Auth - Modern authentication

_{Built with by AskiaDev}