rkx-cli React toolKit eXtend

rkx (React toolKit eXtend) is a lightweight and extensible CLI for bootstrapping and scaling projects in React, Vite, and Next.js.
It includes generators for modules, components, hooks, enums, and types.

🚀 Installation

Global installation (recommended):

npm install -g rkx-cli
# or with yarn
yarn global add rkx-cli

Verify installation:

rkx --help

📦 Available Commands

Create projects

rkx create-react-vite my-app

Scaffolds a new project based on React + Vite with updated dependencies.

Create modules

rkx create-module billing

Generates a module in src/modules/billing from a template.

Create components

rkx create-component Button
rkx create-component Card -m dashboard

• By default components are created in src/core/components.
• With --module (-m), they are added inside the specified module.

Create hooks

rkx create-hook useAuth
rkx create-hook useGoogleMaps -m maps

Generates a hook in src/core/hooks or inside the specified module, along with its type file.

Create enums and types

rkx create-enum Status
rkx create-type User

Generates enum and type files under src/core/types.

⚙️ Common Options

• --force → Overwrite if the file already exists.
• --path <path> → Provide a custom path.
• --template <name> → Use a different template than the default.
• --debug → Print debug information.

📝 Quick Examples

# New React+Vite project
rkx create-react-vite my-dashboard

# New users module
rkx create-module users

# New component inside users module
rkx create-component UserCard -m users

# New global hook
rkx create-hook useTheme

# New enum
rkx create-enum Status

# New type
rkx create-type User

📚 Roadmap

• [x] React+Vite project scaffolding
• [x] Module, component, and hook generators
• [x] Enum and type generators
• [ ] Next.js project scaffolding
• [ ] Customizable templates
• [ ] Third-party plugins/extensions

🛠 Contributing

1. Fork the repo
2. Create a branch feature/new-feature
3. Submit a PR 🎉

📄 License

This project is licensed under the MIT license.