⚡ What is Forgix?

Forgix is not just a cloner — it's an intelligent Project Architect.

Instead of manually copying files and editing configurations, Forgix automates the entire project creation process:

• Injects your personal details
• Sets up your environment
• Opens your workspace instantly
• Remembers who you are with global config

✨ Elite Features

• 🆔 Developer Profile
  Set your global identity once with forgix config. No more re-typing your name or license for every project.

• 🎨 Visual Identity
  Sleek ASCII art branding and categorized, easy-to-read terminal menus.

• 🩺 Smart Doctor
  Built-in diagnostics that don't just find problems—they help fix them.

• 👤 Personalization Engine
  Automatically injects your name and license into:

  • package.json
  • index.html
  • README.md

• 📂 Smart Scaffolding

  • Use pre-built templates (React, Vue, Node, Python)
  • Or clone any public GitHub repository
  • Or link any custom folder on your drive

• 🧩 Plugin Injection
  Select multiple plugins (Docker, Tailwind, etc.) during project creation.

• 🚀 Elite Flow

  • --git → auto initialize repository
  • --open → launch VS Code instantly

🚀 Installation

Run instantly (no install)

npx @7h41c/forgix create

Install globally

npm install -g @7h41c/forgix

🛠️ CLI Commands

| Command | Description | |--------|-------------| | forgix config | Set your global developer name, license, and editor | | forgix doctor | Run system diagnostics with auto-fix capabilities | | forgix list | Show available templates, plugins, and custom links | | forgix create | Start interactive scaffolding wizard | | forgix add <plugin> | Inject a plugin (e.g. Docker) | | forgix link <name> | Link any folder on your PC as a custom template |

💻 Usage Examples

1. Interactive Mode (Standard)

forgix create

2. Speed Mode (Skip Prompts)

forgix create my-app --template react-vite --git --open

3. Remote GitHub Template

forgix create remote-app --template github:user/repo

4. Configure Once, Create Forever

forgix config
forgix create my-app --git --open

🧩 Variable Injection

Forgix scans template files and replaces placeholders automatically:

| Variable | Description | |----------|------------| | {{projectName}} | Your project folder name | | {{author}} | Your name | | {{license}} | Selected license (MIT, ISC, Apache) |

💡 Pro Tips

• 🧼 Keep it clean
  Run:

  forgix doctor

• ⚡ Auto open project

  --open

• ⏭️ Skip dependency install

  --skip-install

• 🆔 Set your identity once

  forgix config

🗺️ Roadmap

• [x] v1.0.7 — Global Config Profile & Smart Doctor Fixes
• [x] v1.0.6 — Interactive Plugin Selection
• [x] v1.0.5 — Custom template linking (forgix link)
• [x] v1.0.4 — ASCII branding & categorized menus
• [x] v1.0.3 — System diagnostics & variable injection
• [ ] v1.0.8 — Forgix Cloud - Sync templates across machines
• [ ] v1.0.9 — "Deep Lens" - Scan existing projects for missing plugins

🤝 Contributing

Contributions are welcome and help improve Forgix.

Steps:

1. Fork the repository
2. Create a branch

   git checkout -b feature/AmazingFeature

3. Commit your changes

   git commit -m "Add AmazingFeature"

4. Push to your branch

   git push origin feature/AmazingFeature

5. Open a Pull Request