🚀 Clixor

Streamline your project setup with Clixor - the modern CLI for effortless development initialization.

Installation • Usage • Features • Contributing • Support

• 🏗️ Project Initialization: Quickly bootstrap projects using predefined or custom templates
• 🎨 Customizable Templates: Easily manage and use your own project templates
• 🧭 Interactive Setup: User-friendly prompts guide you through project configuration
• 📦 Multiple Package Managers: Seamless support for npm, Yarn, and Bun
• 🛠️ Optional Tooling: Integrate popular tools like ESLint, Prettier, Jest, and Docker with ease
• ⚙️ Flexible Configuration: Persist and manage your preferences for future use

npx clixor init my-awesome-project

This command initializes a new project named "my-awesome-project" using Clixor's interactive setup.

• Node.js (v14 or later)
• Git

To install Clixor globally, run:

npm install -g clixor

Now you can use Clixor from anywhere in your terminal:

clixor init my-new-project

By following these steps, users will be able to install and use Clixor globally via npm, which will pull the package from your GitHub repository. The CI/CD pipeline will ensure that new versions are automatically published to npm when you push changes or create new releases on GitHub.

1. Clone the repository:

   git clone https://github.com/Youssefbaghr/Clixor.git cd Clixor

2. Install dependencies:

   npm install # or yarn install # or bun install

3. Link the CLI globally:

   npm link

Clixor now features a sleek website built with Next.js, offering a comprehensive overview of the project.

1. Navigate to the website directory:

   cd website

2. Install dependencies:

   yarn install

3. Run the development server:

   yarn dev

For your convenience, you can use these Yarn scripts from the root directory:

• Development mode:

  yarn website:dev

• Production build:

  yarn website:build

• Start production server:

  yarn website:start

• 📚 Documentation: In-depth guides on Clixor usage and features
• 🖼 Template Showcase: Explore available project templates
• 🔧 Interactive Examples: Try Clixor commands directly in your browser
• 📰 Blog: Stay updated with the latest Clixor news and tips
• 🤝 Community: Connect with other Clixor users and contributors

Visit our website to discover how Clixor can streamline your development workflow!

Clixor comes with a Visual Studio Code extension to enhance your development experience. To use the extension:

1. Open VS Code
2. Go to the Extensions view (Ctrl+Shift+X)
3. Search for "Clixor"
4. Install the Clixor extension
5. Use the command palette (Ctrl+Shift+P) and search for "Clixor: Initialize New Project" to create a new Clixor project directly from VS Code.

clixor init

Follow the interactive prompts to configure your project.

clixor config --list clixor config --set templateDir=/path/to/templates clixor config --reset

clixor template --list clixor template --add react-ts https://github.com/example/react-ts-template.git clixor template --remove react-ts 

Clixor uses a JSON configuration file stored at ~/.Clixor-config.json. You can edit this file directly or use the clixor config command.

Example configuration:

{ "defaultTemplate": "react", "packageManager": "npm", "features": ["eslint", "prettier"], "customTemplates": { "react-ts": "https://github.com/example/react-ts-template.git" } }

1. Create a Git repository with your project structure
2. Add a clixor.json file to specify template options:

   { "variables": ["projectName", "author"], "scripts": { "post-init": "npm run setup" } }

3. Add the template using clixor template --add

Clixor supports a plugin system that allows you to extend its functionality. Here's how to create a plugin:

1. Create a new TypeScript file in the src/plugins directory.
2. Import the PluginInterface from src/plugins/types/index.ts.
3. Create a class that implements the PluginInterface.
4. Implement the required methods:
   • name: A string identifier for your plugin.
   • version: The version of your plugin.
   • initialize: A method called when the plugin is registered.
   • execute: The main functionality of your plugin.

Example plugin:

import { PluginInterface } from '../types'; export class MyCustomPlugin implements PluginInterface { name = 'MyCustomPlugin'; version = '1.0.0'; initialize(): void { console.log('MyCustomPlugin initialized'); } async execute(context: any): Promise<string> { return MyCustomPlugin executed with context: ${JSON.stringify(context)}; } }

To use your plugin, register it in the src/utils/plugins.ts file:

import { MyCustomPlugin } from '../plugins/MyCustomPlugin'; // In the loadPlugins function const myCustomPlugin = new MyCustomPlugin(); myCustomPlugin.initialize(); // Add logic to use the plugin as needed

Plugins allow you to add new commands, modify existing functionality, or integrate with external services to enhance Clixor's capabilities.

We love our contributors! ❤️ Check out the CONTRIBUTORS.md file to see the amazing people who have helped make Clixor awesome.

Want to join this list of amazing people? We'd love your help! Here's how you can contribute:

1. 🍴 Fork the repository
2. 🌿 Create a new branch
3. ✨ Make your changes
4. 🔧 Test your changes
5. 📤 Submit a pull request

For more detailed information, please read our Contributing Guide.

Whether it's submitting a bug report, proposing a new feature, or improving documentation - every contribution counts!

See CHANGELOG.md for a history of changes to this project.

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

• Commander.js - CLI framework
• Inquirer.js - Interactive prompts
• Chalk - Terminal styling