Creator v1.0 🚀

About

Creator is a command-line tool designed to help maintain a consistent folder structure in your projects, particularly tailored for React Native applications. It allows you to define and enforce a folder structure pattern through a config.json file.

📝 Table of Contents

• Features
• Downloading Artifacts
• Installation
• Usage
• Contributing
• License
• Acknowledgements
• Contact

Features

• Dynamic Configuration System: 100% configuration-driven CLI with no hardcoded commands
• Flexible Project Structures: Support for any project architecture via JSON configuration
• Static & Dynamic Categories: Create both predefined items and dynamic items at runtime
• Interactive CLI: Rich hierarchical navigation with helpful error messages
• Template Engine: Full Handlebars template support for consistent code generation
• Auto-Discovery: Automatic detection of config files and source directories
• Preset System: Ready-to-use presets for Clean Architecture and Module-based patterns
• CLI Commands: Modern command interface with create, list, and init commands
• Performance Optimized: <100ms startup time with efficient config parsing
• Graceful Error Handling: Helpful error messages with quick-fix suggestions

Downloading Artifacts

Currently, you can download pre-built binaries for this project from the Releases page. Select the appropriate version and download the binary for your platform.

Installation

After downloading the binary, you can follow these steps to install and use the CLI:

1. Linux:

   chmod +x creator
   sudo mv creator /usr/local/bin/

2. macOS:

   chmod +x creator
   mv creator /usr/local/bin/

Usage

TODO: include screenshots or gif

You can see all the CLI commands by running the following command.

creator --help

Screen.Recording.2024-03-05.at.22.56.43.mov

Contributing

We welcome contributions to make Creator even better. If you have suggestions, bug reports, or want to contribute code, follow these steps:

1. Assuming that you have

   • Installed and configured git
   • Installed Rust
   • Setup an SSH key

2. To run Creator on your machine in developer mode, follow these steps:

   # Clone the repository
   git clone https://github.com/andraderaul/creator.git
   
   # Change into the project directory
   cd creator
   
   # Build the project
   cargo build
   
   # Run the project
   cargo run -- new-feature my_feature

3. Fork the project.

4. Create your feature branch: git checkout -b feature/my-feature.

5. Commit your changes: git commit -am 'Add new feature'.

6. Push to the branch: git push origin feature/my-feature.

7. Submit a pull request.

License

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

Acknowledgements

TODO: Improve this section

Contact

For questions, feedback, or issues, feel free to reach out:

• Email: theandraderaul@gmail.com