⚔️ React Forge CLI

React Forge is a premium, high-performance project architect and bundler wrapper designed to bootstrap production-ready React applications with advanced folder structures, theming engines, and professional toolsets in seconds.

🚀 Key Features

1. Hybrid Scaffolding Engine

Forge leverages the speed of Vite and the robustness of Next.js as core drivers, ensuring your project starts with an industry-standard build pipeline.

2. Intelligent Project Blueprints

Don't start with a blank screen. Choose from curated project archetypes:

• Minimalist: A clean slate for custom builds.
• SaaS Dashboard: Pre-configured with sidebars, layouts, and sample metrics.
• Landing Page: Optimized for marketing and SEO.
• Portfolio: Designed for creative expression and smooth animations.

3. Dynamic Theming & Design Tokens

Forge automatically generates a customized Tailwind CSS configuration based on your aesthetic choice (Zinc, Slate, Violet, or Emerald). It injects HSL color variables into your global CSS, allowing for instant, system-wide design consistency.

4. Professional Tool Selection

One-click integration for the industry's best libraries:

• 🧩 Zustand: Simplified state management.
• ⚡ TanStack Query: Advanced data fetching.
• ✨ Framer Motion: Smooth, high-performance animations.
• 🎨 Lucide Icons: A beautiful, consistent icon set.
• 📐 Atomic Design: Automated folder hierarchy (atoms, molecules, organisms) to scale your UI.

5. Production-Ready Environment

• Automatic Git Initialization: Ready for version control out of the box.
• Quality Control: Pre-configured ESLint and Prettier setups.
• TypeScript Support: First-class citizen with automatic type definition management.
• Smart Logging: Granular step tracking with persistent audit logs stored in ~/.config/react-forge/logs.

🛠️ Quick Start (Recommended)

The fastest way to use React Forge is via npx. No installation is required:

npx react-forge-cli

🏗️ Manual Installation & Development

Global Installation

If you prefer to have it available as a permanent command:

npm install -g react-forge-cli
react-forge

Local Development

To run the forge directly from the source:

# Clone the repository
git clone https://github.com/NodePulse/react-forge-cli.git
cd react-forge-cli

# Install internal dependencies
npm install

# Start forging
node cli/index.js

📂 Project Structure

react-forge/
├── cli/
│   ├── index.js          # Interactive CLI Entry Point
│   ├── forge.js          # Core Generation Engine
│   └── utils/
│       └── logger.js     # Production-level logging system
├── package.json          # Project metadata and dependencies
└── README.md             # You are here!

🧠 Configuration Persistence

React Forge remembers your preferences. Your last used tech stack is stored in ~/.config/react-forge/config.json, allowing you to re-forge similar projects with a single click using the "Use previous configuration" option.

🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

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 ISC License. See package.json for more information.

Forged with ❤️ by the React Forge Team.