https://github.com/involvex/chaos-create
🎲 Create random apps with chaos and creativity! A CLI tool that generates random application scaffolds using various frameworks, libraries, and features.
https://github.com/involvex/chaos-create
Last synced: 4 days ago
JSON representation
🎲 Create random apps with chaos and creativity! A CLI tool that generates random application scaffolds using various frameworks, libraries, and features.
- Host: GitHub
- URL: https://github.com/involvex/chaos-create
- Owner: involvex
- License: mit
- Created: 2026-05-03T02:37:49.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-03T06:41:40.000Z (about 1 month ago)
- Last Synced: 2026-05-03T08:27:23.262Z (about 1 month ago)
- Language: TypeScript
- Size: 50.8 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# 🎲 chaos-create
Create random apps with chaos and creativity! A CLI tool that generates random application scaffolds using various frameworks, libraries, and features.
## Features
- 🎲 **Smart Randomization**: Intelligently selects frameworks based on category, popularity, and stability
- 🔥 **Chaos Mode**: Wild combinations that ignore compatibility rules
- 📦 **Library Injection**: Automatically adds random libraries to spice up your project
- ✨ **Feature Generation**: Generates random feature ideas with working examples
- 🌐 **Multi-Framework Support**: Web, mobile, desktop, CLI, and backend frameworks
- 💬 **Interactive Prompts**: User-friendly CLI interface
- 🚀 **Quick Start**: Automatic dependency installation and dev server startup
## Supported Frameworks
### Web
- React (Vite)
- Next.js
- Vue (Vite)
- Nuxt
- Svelte
- SolidJS
- Angular
- SvelteKit
- Astro
- Remix
- SolidStart
- Vite React TypeScript
- Next.js Starter
### Mobile
- React Native
- Expo
- Expo Stack
- Flutter
- Ionic
- Capacitor
### Desktop
- Tauri
- Electron
- Neutralino
### CLI/Terminal
- Ink (React CLI)
- TUI Framework
- Deno CLI
- Clack
- Cliffy
### Backend
- Deno
- Bun Backend
- Node.js Express
- Fastify
- Koa
- Hono
- NestJS
## Installation
```bash
# Clone the repository
git clone https://github.com/involvex/chaos-create.git
cd chaos-create
# Install dependencies
bun install
# Make it executable (optional)
chmod +x src/index.ts
```
## Usage
### Create a Random App
```bash
bun run src/index.ts create
```
This will prompt you for:
- Project name
- Output directory
- App category (or random)
- Chaos mode toggle
- Library injection options
- Feature generation options
- Dependency installation
- Dev server startup
### Command Line Options
```bash
bun run src/index.ts create [options]
Options:
-c, --category App category (web, mobile, desktop, cli, backend)
-f, --framework Specific framework to use
-t, --template Git template URL to use instead of random framework
--chaos Enable chaos mode (wild combinations)
--no-libs Skip random library injection
--no-features Skip random feature generation
--lib-count Number of random libraries (default: 3)
--no-install Skip dependency installation
--start Start dev server after installation
```
### Examples
```bash
# Create a random web app
bun run src/index.ts create --category web
# Create a React Native app with chaos mode
bun run src/index.ts create --framework react-native --chaos
# Create a backend app without libraries
bun run src/index.ts create --category backend --no-libs
# Pure chaos mode
bun run src/index.ts chaos
```
### List Available Frameworks
```bash
bun run src/index.ts list
```
### Git Templates
Create projects from git templates:
```bash
# Create from a git template
bun run src/index.ts create --template https://github.com/user/template
# List templates from a repository
bun run src/index.ts template --url https://github.com/user/repo --list
# Validate a template
bun run src/index.ts template --url https://github.com/user/repo --validate
# List popular templates
bun run src/index.ts template --popular
# Clear template cache
bun run src/index.ts template --clear-cache
```
## How It Works
1. **Framework Selection**: Uses weighted randomization based on popularity and stability
2. **Smart Categorization**: Respects category boundaries (unless in chaos mode)
3. **Library Injection**: Adds compatible libraries based on the selected framework
4. **Feature Generation**: Creates working example code for random features
5. **Project Creation**: Executes the appropriate CLI command for the framework
6. **Dependency Management**: Uses bun as the default package manager
## Chaos Mode
Chaos mode disables compatibility rules and creates truly wild combinations:
```bash
bun run src/index.ts create --chaos
```
In chaos mode, you might get:
- React Native with Deno backend libraries
- Flutter with React state management
- CLI apps with mobile-specific features
- Any combination imaginable!
## Project Structure
```
chaos-create/
├── src/
│ ├── index.ts # Main CLI entry point
│ ├── prompts.ts # Interactive prompts
│ ├── framework-registry.ts # Framework database
│ ├── randomizer.ts # Randomization engine
│ ├── generators/
│ │ ├── framework-generator.ts # Framework CLI wrappers
│ │ ├── library-injector.ts # Library injection
│ │ └── feature-generator.ts # Feature code generation
│ └── utils/
│ └── logger.ts # Terminal output utilities
├── docs/
│ ├── README.md # Documentation index
│ ├── ADVANCED_USAGE.md # Advanced usage guide
│ └── API.md # API documentation
├── package.json
├── tsconfig.json
└── README.md
```
## Documentation
For comprehensive documentation, check out the [docs](./docs/) directory:
- **[Getting Started](./README.md#installation)** - Installation and basic usage
- **[Advanced Usage](./docs/ADVANCED_USAGE.md)** - Advanced features and configurations
- **[API Documentation](./docs/API.md)** - Complete API reference
- **[Contributing Guide](./CONTRIBUTING.md)** - How to contribute
- **[Changelog](./CHANGELOG.md)** - Version history and changes
### Quick Documentation Links
- [Configuration Options](./docs/ADVANCED_USAGE.md#configuration)
- [Custom Templates](./docs/ADVANCED_USAGE.md#custom-templates)
- [Framework Registry](./src/framework-registry.ts)
- [Feature Templates](./src/generators/feature-generator.ts)
- [Troubleshooting](./docs/ADVANCED_USAGE.md#troubleshooting)
## Contributing
Contributions are welcome! Areas for improvement:
- Add more frameworks to the registry
- Improve the feature code templates
- Add git template integration
- Create more chaos mode combinations
- Add tests
- Improve error handling
## Funding
If you find this project useful, consider supporting its development:
- **GitHub Sponsors**: [Sponsor involvex](https://github.com/sponsors/involvex)
- **Star the repo**: ⭐ on GitHub to show your support
## License
MIT © [involvex](https://github.com/involvex)
## Author
Created by [involvex](https://github.com/involvex) with 🎲 and chaos
---
**Warning**: This tool is designed for learning and exploration. Generated projects may contain unconventional combinations that are not suitable for production use.