🛠️ Project|Forge - Organize Your Projects with Ease

Do you have Arduino sketches, random STL files, and project folders everywhere? Project|Forge is here to transform your chaotic workspace into a maker’s paradise.


📑 Features:

  • Auto-detection: Identifies Arduino, PlatformIO, and other common project types.
  • Folder Organization: Structures code, CAD files, docs, and hardware neatly.
  • Windows-Friendly: Optimized for WSL, great for mixed-OS setups.
  • Beginner and Expert Friendly: Setup options for beginners, WSL users, and Linux pros.

🎯 Ideal for:

  • Arduino, PlatformIO, or multi-software projects
  • Organizing scattered code snippets, 3D models, and docs

🚀 Quick Start:

Install Required Tools (WSL/Linux)

sudo apt update && sudo apt install python3 python3-pip python3-yaml git

Clone the Repo and Run Project|Forge

git clone https://github.com/Kalougear/ProjectForge.git
cd ProjectForge
python3 -m project_forge

📂 Example Folder Structure

After Running Project|Forge:

MyProject/
├── software/       # Source code
├── hardware/       # Schematics, PCBs
├── cad/            # CAD files, 3D models
├── _docs/          # Documentation
└── builds/         # Build outputs

🆘 Troubleshooting

  • Path Not Found: Ensure WSL paths (/mnt/c/...) are used.
  • Python Issues: Run sudo apt install --reinstall python3 python3-pip.
  • Script Errors: Ensure you're in the ProjectForge directory.

📂 Real-World Examples

  1. Arduino Project - Before: messy Desktop, After: organized into structured folders.
  2. Code Snippet Archive - Organizes loose code into reusable modules.

💡 Pro Tips

  • Use descriptive project names.
  • Use ONGOING for active projects, and DONE for completed ones.
  • Keep code snippets in Code_Archives for easy access.

📝 License

MIT License - For makers, by makers!

🤝 Contribute

Check out our GitHub repo to suggest features or contribute.