logo

Version

Creator is a TUI application designed to simplify starting new projects using user-defined templates.

screenshot1

Contributions are welcome! Feel free to submit feature requests or bug reports.

• creator - start a new project not from scratch
  • Table of Contents
  • 📺 Demo
  • 🚀 Installation
  • 🌱 Environment variables
  • 📂 Template Structure
    • Storage Layout
    • Template Variables
  • 💡 Notes
  • ❤️ Aknowledgements
  • 🤝 Contribute
  • License

demo

1. Copy the application to your desired location.
2. Set up templates:
   • Place your templates in ~/.creator-templates, or
   • Define a custom location using the CREATOR_TEMPLATES environment variable.
   • You may want to copy templates from the examples directory as a starting point.
3. Add Creator to PATH:
   • Ensure the application directory is included in your system's PATH.
4. Run Creator:
   • Navigate to the directory where you want to create a new project and run: creator.
5. Enjoy! 🎉

• CREATOR_TEMPLATES: Specifies the path to your templates directory.

Storage/
 |- group_a/
 | |- template_directory_a/
 | | |- [files and dirs]
 | |- template_directory_b/
 | | |- [files and dirs]
 | | |- ...
 | ...
 |
 |- group_b/
 | |- template_directory_a/
 | | |- [files and dirs]
 | ...
 |
 ...
 

Note: dotfiles and directories are ignored by the application.

You can define variables within template files and filenames using the following syntax:

• @{Name of a Variable}@ - This placeholder will be replaced with user-defined values during project creation. And will be prompted like this:

Name of a Variable: ________

Yes, you can use spaces in the variable name! 😄

• Template Groups: Organize your templates into logical groups for easy navigation.
• Customizable Variables: Enhance templates by leveraging variable placeholders for dynamic project creation.

For questions, feedback, or contributions, don't hesitate to reach out!

For the application design and architecture see docs/design.md.

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