Stack-Gen

A powerful CLI tool to generate production-ready full-stack applications with customizable configurations.

Description

stack-gen helps developers quickly scaffold full-stack applications with modern tech stacks. It provides an interactive command-line interface to select and configure your preferred stack components, saving hours of initial setup time.

Features

• Generate MERN (MongoDB, Express, React, Node.js) stacks
• Generate PERN (PostgreSQL, Express, React, Node.js) stacks
• Multiple client configurations with Tailwind CSS and Shadcn UI
• Advanced server options with JWT authentication and caching
• Customizable project structure

Installation

1# Install globally (Recommended)
2npm install -g @aditya_kbr01/stack-gen
3npm install -g stack-gen
4
5# Or use with npx
6npx @aditya_kbr01/stack-gen

Usage

Run the CLI and follow the interactive prompts:

1# If installed globally
2npx @aditya_kbr01/stack-gen
3
4# Or using npx
5npx @aditya_kbr01/stack-gen

Interactive Prompts

The CLI will guide you through a series of questions:

1. Project name
2. Stack selection (MERN or PERN)
3. Server configuration
4. Client configuration

Example session:

1$ stack-gen
2? Enter your project name: my-awesome-app
3? Choose Stack: PERN
4? Choose a Server: Advance Server (Recommended)
5? Choose Advance Server Variant: With JWT and Cache
6? Choose a Client: Advance Client (Recommended)
7? Choose Advance Client Variant: tailwind-shadcn-zinc

Available Options

Stack Options

• MERN: MongoDB, Express, React, Node.js
• PERN: PostgreSQL, Express, React, Node.js

Server Options

• Basic Server: Minimal Express server setup
• Advance Server:
  • with-jwt: Express server with JWT authentication
  • with-jwt-and-cache: Express server with JWT and caching

Client Options

• Basic Client: Minimal React setup with TypeScript and Vite
• Advance Client:
  • tailwind: React with Tailwind CSS
  • tailwind-shadcn-gray: React with Tailwind CSS and Shadcn UI (Gray theme)
  • tailwind-shadcn-slate: React with Tailwind CSS and Shadcn UI (Slate theme)
  • tailwind-shadcn-neutral: React with Tailwind CSS and Shadcn UI (Neutral theme)
  • tailwind-shadcn-stone: React with Tailwind CSS and Shadcn UI (Stone theme)
  • tailwind-shadcn-zinc: React with Tailwind CSS and Shadcn UI (Zinc theme)

Project Structure

The generated project will have the following structure:

my-stack-project/
├── client/             # Frontend React application
│   ├── public/         # Static assets
│   ├── src/            # React source code
│   ├── package.json    # Frontend dependencies
│   └── ...
├── server/             # Backend Express application
│   ├── src/            # Server source code
│   ├── package.json    # Backend dependencies
│   └── ...
└── package.json        # Root package.json for project-wide scripts

Development

To contribute to the stack-gen:

1. Clone the repository:

   1git clone https://github.com/Adityakbr01/stack-gen.git
   2cd stack-gen

2. Install dependencies:

   1npm install

3. Build the project:

   1npm run build

4. Link the package locally for testing:

   1npm link

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For support, issues, or feature requests, please file an issue on the GitHub repository.

---

Made with ❤️ by Adityakbr01