🚀 Turbo Dev CLI

The Ultimate CLI Toolkit for Modern Developers

npm install -g turbo-dev-cli

Installation • Features • Quick Start • Documentation • Contributing

🎯 What is Turbo Dev CLI?

Turbo Dev CLI is a comprehensive, all-in-one command-line toolkit designed to supercharge your development workflow. From file organization to deployment automation, from code analysis to database management - everything you need in one powerful CLI.

🌟 Why Choose Turbo Dev CLI?

• 🚀 Productivity Boost: Automate repetitive tasks and focus on what matters
• 🛠️ All-in-One: 12+ tools in a single CLI - no need for multiple packages
• 🎨 Beautiful Interface: Colorful, intuitive output with progress indicators
• ⚡ Lightning Fast: Optimized for speed and efficiency
• 🔧 Highly Configurable: Customize everything to match your workflow
• 📚 Well Documented: Comprehensive guides and examples

✨ Features

🗂️ File Management

• Smart file organization by type
• Bulk file operations
• Directory cleanup tools
• Duplicate file detection

🌿 Git Automation

• Interactive commit workflows
• Branch management
• Automated cleanup
• Git hooks integration

🚀 Project Scaffolding

• 10+ professional templates
• Custom template creation
• Best practices included
• Framework-specific setups

🔍 Code Analysis

• Code quality metrics
• Dependency analysis
• Performance insights
• Security recommendations

🐳 DevOps Tools

• Docker configuration
• CI/CD pipeline setup
• Deployment automation
• Environment management

🔐 Security & Utils

• Password generation
• API testing tools
• Database management
• Todo list integration

📦 Installation

🚀 Quick Install (Recommended)

# Install globally with npm
npm install -g turbo-dev-cli

# Start using immediately
turbo welcome

📋 All Installation Methods

Global Installation (Recommended)

npm install -g turbo-dev-cli

✅ Use turbo command anywhere
✅ Best for daily development
✅ Auto-updates available

No Installation (npx)

npx turbo-dev-cli [command]

✅ No global installation needed
✅ Always uses latest version
✅ Perfect for trying out

Yarn Global

yarn global add turbo-dev-cli

✅ For Yarn users
✅ Global access

Local Project Installation

npm install turbo-dev-cli
npx turbo [command]

✅ Project-specific version
✅ Team consistency

✅ Verify Installation

# Check version
turbo --version

# See welcome screen
turbo welcome

# Get help
turbo --help

🔧 Requirements

• Node.js: 16.0.0 or higher
• npm: 7.0.0 or higher (comes with Node.js)
• Operating System: Windows, macOS, or Linux

🚀 Quick Start

First time? Install with: npm install -g turbo-dev-cli

1. Welcome Screen

turbo welcome

2. Organize Your Files

# Preview what will be organized
turbo organize ~/Downloads --dry-run

# Actually organize files
turbo organize ~/Downloads --execute

3. Create a New Project

turbo scaffold
# Choose from React, Vue, Node.js, Express, and more!

4. Generate Secure Passwords

turbo password quick -c 5 -l 20

5. Analyze Your Code

turbo analyze code

📖 Documentation

🗂️ File Organization

Automatically organize messy directories by file type:

# Basic usage
turbo organize [directory]

# Options
turbo organize ~/Downloads --dry-run    # Preview changes
turbo organize . --execute              # Apply changes
turbo org --help                        # Show all options

Supported File Types:

• Images: .jpg, .png, .gif, .svg, .webp
• Documents: .pdf, .doc, .txt, .md
• Videos: .mp4, .avi, .mkv, .mov
• Audio: .mp3, .wav, .flac, .aac
• Archives: .zip, .rar, .7z, .tar.gz
• Code: .js, .ts, .py, .java, .cpp

🌿 Git Helpers

Streamline your Git workflow:

turbo git quick              # Interactive commit
turbo git info               # Branch and commit info
turbo git clean              # Clean merged branches

🚀 Project Scaffolding

Create professional projects instantly:

turbo scaffold              # Interactive mode
turbo new                   # Alias

Available Templates:

| Template | Description | Technologies | |----------|-------------|--------------| | Node.js API | RESTful API server | Express, ESLint, Nodemon | | React App | Modern React application | React 18, Vite, TypeScript | | Vue.js App | Vue 3 application | Vue 3, Composition API, Vite | | Next.js App | Full-stack Next.js | Next.js 14, TypeScript, Tailwind | | Express API | Express server | Express, Middleware, CORS | | TypeScript Library | NPM package template | TypeScript, Rollup, Jest | | CLI Tool | Command-line app | Commander.js, Inquirer |

🎨 Code Formatting

Format and beautify your code:

turbo format "**/*.{js,ts,json}"     # Format specific files
turbo fmt --dry-run                  # Preview formatting
turbo fmt --execute                  # Apply formatting

📦 Asset Optimization

Analyze and optimize your project:

turbo optimize images        # Image size analysis
turbo optimize bundle        # Bundle size analysis
turbo optimize perf          # Performance metrics

🔐 Password Generation

Generate secure passwords with customizable options:

turbo password generate      # Interactive mode
turbo pwd quick -l 20 -c 5   # 5 passwords, 20 chars each
turbo pwd check              # Check password strength

Features:

• Customizable length (4-128 characters)
• Character set selection (uppercase, lowercase, numbers, symbols)
• Strength analysis
• Bulk generation
• Safe symbols option

📝 Todo Management

Terminal-based todo list with priorities:

turbo todo add               # Add new todo
turbo todo list              # List all todos
turbo todo list --pending    # Show only pending
turbo todo complete          # Mark as completed
turbo todo clear             # Clear completed todos

🔍 Code Analysis

Advanced code quality and project analysis:

turbo analyze code           # Code quality metrics
turbo analyze deps           # Dependency analysis
turbo analyze perf           # Performance analysis
turbo analyze all            # Complete analysis

Analysis Features:

• Code complexity metrics
• TODO/FIXME comment detection
• Large file identification
• Console statement detection
• Dependency vulnerability check
• Bundle size optimization tips

🐳 Docker Integration

Easy containerization setup:

turbo docker init            # Interactive Docker setup
turbo docker status          # Check Docker installation

Generated Files:

• Dockerfile (optimized for your project type)
• docker-compose.yml (with database services)
• docker-compose.dev.yml (development environment)
• .dockerignore (optimized exclusions)

🗄️ Database Tools

Database setup and management:

turbo database setup         # Interactive database setup
turbo db migration           # Create migration
turbo db seed               # Create seed file

Supported Databases:

• PostgreSQL (with Sequelize)
• MySQL (with Sequelize)
• MongoDB (with Mongoose)
• SQLite (with Sequelize)
• Redis (connection setup)

🔌 API Development

API testing and documentation tools:

turbo api test              # Interactive API testing
turbo api docs              # Generate API documentation

Documentation Formats:

• Markdown documentation
• OpenAPI/Swagger specification
• Postman collection

🚢 Deployment

Deploy to popular platforms:

turbo deploy interactive     # Interactive deployment
turbo deploy vercel          # Deploy to Vercel
turbo deploy netlify         # Deploy to Netlify
turbo deploy github          # Setup GitHub Pages
turbo deploy docker          # Create production Dockerfile

⚙️ Configuration

Global Configuration

Create ~/.turbo-config.json:

{
  "defaultEditor": "code",
  "gitAutoCommit": false,
  "organizerRules": {
    "images": [".jpg", ".png", ".gif", ".webp", ".svg"],
    "documents": [".pdf", ".doc", ".docx", ".txt", ".md"],
    "videos": [".mp4", ".avi", ".mkv", ".mov", ".wmv"],
    "audio": [".mp3", ".wav", ".flac", ".aac", ".ogg"]
  },
  "passwordDefaults": {
    "length": 16,
    "includeSymbols": true,
    "excludeSimilar": true
  },
  "scaffoldDefaults": {
    "author": "Your Name",
    "license": "MIT",
    "gitInit": true
  }
}

Environment Variables

# Enable verbose logging
export TURBO_VERBOSE=true

# Custom config directory
export TURBO_CONFIG_DIR=~/.config/turbo

# Disable update notifications
export TURBO_NO_UPDATE_CHECK=true

🎨 Examples

Complete Project Setup Workflow

# 1. Create new project
turbo scaffold

# 2. Setup database
turbo db setup

# 3. Setup Docker
turbo docker init

# 4. Analyze code quality
turbo analyze all

# 5. Setup deployment
turbo deploy interactive

File Organization Workflow

# Organize Downloads folder
turbo organize ~/Downloads --execute

# Organize current project
turbo organize . --dry-run
turbo organize . --execute

# Organize with custom rules
turbo organize ~/Pictures --execute

Development Workflow

# Quick git workflow
turbo git quick

# Generate API documentation
turbo api docs

# Test API endpoints
turbo api test

# Deploy to production
turbo deploy vercel

🛠️ Development

Setup Development Environment

git clone https://github.com/turbodev/turbo-dev-cli.git
cd turbo-dev-cli
npm install
npm link

Project Structure

turbo-dev-cli/
├── bin/
│   └── cli.js              # Main CLI entry point
├── src/
│   └── commands/           # Command implementations
│       ├── analyze.js      # Code analysis tools
│       ├── api.js          # API development tools
│       ├── database.js     # Database management
│       ├── deploy.js       # Deployment tools
│       ├── docker.js       # Docker integration
│       ├── format.js       # Code formatting
│       ├── git.js          # Git helpers
│       ├── optimize.js     # Asset optimization
│       ├── organize.js     # File organization
│       ├── password.js     # Password generation
│       ├── scaffold.js     # Project scaffolding
│       └── todo.js         # Todo management
├── package.json
├── README.md
└── LICENSE

Running Tests

npm test

Linting

npm run lint

Building

npm run build

🤝 Contributing

We welcome contributions! Here's how you can help:

🐛 Bug Reports

Found a bug? Please create an issue with:

• Clear description of the problem
• Steps to reproduce
• Expected vs actual behavior
• System information (OS, Node.js version)

💡 Feature Requests

Have an idea? We'd love to hear it! Please include:

• Clear description of the feature
• Use case and benefits
• Possible implementation approach

🔧 Pull Requests

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Make your changes
4. Add tests if applicable
5. Run linting: npm run lint
6. Commit changes: git commit -m 'Add amazing feature'
7. Push to branch: git push origin feature/amazing-feature
8. Open a Pull Request

📝 Development Guidelines

• Follow existing code style
• Add JSDoc comments for new functions
• Update README for new features
• Add tests for new functionality
• Keep commits atomic and well-described

📊 Stats & Analytics

🙏 Acknowledgments

Special thanks to these amazing projects that make Turbo Dev CLI possible:

• Commander.js - Command-line interface framework
• Chalk - Terminal string styling
• Inquirer.js - Interactive command line prompts
• Ora - Elegant terminal spinners
• Figlet - ASCII art text
• Boxen - Create boxes in terminal

📞 Support & Community

• 📧 Email: [email protected]
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 🐦 Twitter: @TurboDevCLI
• 💬 Discord: Join our Discord

📈 Roadmap

v1.1.0 (Coming Soon)

• [ ] Plugin system for custom commands
• [ ] Configuration wizard
• [ ] More project templates
• [ ] Integration with popular IDEs

v1.2.0

• [ ] Cloud deployment integrations
• [ ] Advanced code metrics
• [ ] Team collaboration features
• [ ] Performance monitoring

v2.0.0

• [ ] Web dashboard
• [ ] AI-powered code suggestions
• [ ] Multi-language support
• [ ] Enterprise features

📄 License

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

Made with ❤️ by the Xaynx Team

Boost your development productivity with Turbo Dev CLI!