Forge

Forge is an opinionated environment and configuration generator for modern web applications. It helps you bootstrap the infrastructure configuration for your projects quickly and consistently.

forge-cli.mp4

Features

• Interactive CLI: Easy-to-use dialog-based interface.
• Frontend: Next.js (App Router), React (Vite).
• Backend: Express (Node.js), FastAPI (Python).
• Database: Postgres, MySQL, MongoDB, SQLite.
• Auth: Built-in JWT scaffolding with Login/Register routes.
• DevOps: Auto-generated docker-compose.yml and GitHub Actions CI.

Installation

Install (No Rust required)

Download the latest binary for your OS from the Releases page.

Linux / macOS:

1. Download the binary.
2. Make it executable: chmod +x forge
3. Move it to your path: sudo mv forge /usr/local/bin/

Windows:

1. Download the .exe file.
2. Add it to your PATH.

Install from source (Rust required)

Ensure you have Rust and Cargo installed.

git clone https://github.com/AVBharath10/Forge-CLI.git
cd forge
cargo install --path .

Usage

Run the init command to start the interactive generator:

forge init

Generated Stack

Running forge init will create a directory containing:

• Frontend: A fully configure Web App.
• Backend: Server with pre-configured DB connection and Auth.
• Infrastructure: CI/CD workflows and Docker Compose files.
• .env: A pre-filled .env file (and .env.example).

Contributing

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

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

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