Polystart 🚀

An interactive CLI tool for scaffolding full-stack projects with your favorite frameworks

🚀 Polystart — Spin Up Any Project, Instantly

Have you ever wanted to quickly prototype a project using different frontend or backend frameworks, but found yourself wasting time searching for the right commands, installing dependencies, and rewriting the same boilerplate code over and over?

Polystart solves that.

Polystart is an all-in-one project starter that helps you generate clean, ready-to-run boilerplates for the most popular frameworks — both frontend and backend — with a single command. No more context switching, no more Googling setup guides, and no more wasted time.

Start faster. Experiment freely. Build more.

Polystart simplifies project initialization by providing an intuitive, interactive interface to set up both frontend and backend frameworks in one go. No more juggling multiple CLI tools or manually configuring project structures.

✨ Features

• 🎯 Interactive Prompts: Beautiful, user-friendly prompts powered by @clack/prompts
• 🎨 Frontend Support: Scaffold projects with Next.js, Vue, Svelte, or Solid (with more to come!)
• ⚙️ Backend Support: Set up Express.js or FastAPI backends with routing included!
• 🔧 Flexible Configuration: Customize TypeScript, linters, testing frameworks, and more
• 📦 Smart Project Generation: Automatically generates boilerplate code and project structure

📦 Installation

npm install -g polystart

Or use with npx:

npx polystart

🎬 Usage

Simply run the command:

npx polystart

The tool will guide you through:

1. Frontend Framework Selection: Choose from Next.js, React, Vue, Svelte, Solid, or None
2. Frontend Configuration: Configure TypeScript, linters, testing, styling, and other options
3. Backend Framework Selection: Choose from Express, FastAPI, or None
4. Backend Configuration: Set up entry points, ports, routes, and dependencies

🎨 Supported Frameworks

Frontend

• Next.js: Full Next.js setup with App Router, TypeScript, TailwindCSS, and more
• React: React project scaffolding
• Vue: Vue.js projects with TypeScript, Router, Pinia, and testing options
• Svelte: SvelteKit projects with templates, TypeScript, and feature add-ons
• Solid: Solid.js project setup

Backend

• Express: Node.js Express server with TypeScript support, CORS, and route generation
• FastAPI: Python FastAPI backend setup

🔧 Configuration Options

Frontend Options

Each frontend framework offers various configuration options:

• TypeScript/JavaScript: Choose your preferred language
• Linters: ESLint, Biome, or none
• Testing: Vitest, Playwright, Cypress, and more
• Styling: TailwindCSS, CSS modules, etc.
• State Management: Pinia (Vue), etc.
• Routing: Built-in router configuration

Backend Options

• Entry Point: Customize your main file name
• Port: Configure server port
• TypeScript: Full TypeScript support
• CORS: Enable/disable CORS middleware
• Routes: Generate multiple route files with boilerplate

🛠️ Development

Prerequisites

• Node.js 18+
• npm, pnpm, or yarn

Building

npm run build

Project Structure

src/
├── backend/          # Backend framework implementations
├── frontend/         # Frontend framework implementations
├── base/             # Base classes and generators
├── utils/            # Utility functions
└── main.ts           # Entry point

🤝 Contributing

Contributions are welcome! Feel free to:

• Report bugs
• Suggest new features
• Submit pull requests
• Add support for new frameworks

📝 License

MIT

🙏 Acknowledgments

Built with:

• @clack/prompts - Beautiful CLI prompts
• execa - Process execution
• semver - Semantic versioning

Made with ❤️ for developers who want to start building faster