Environment Setup v1.0

A comprehensive, production-ready development environment setup for macOS with AI tools, designed for full-stack JavaScript/TypeScript development.

✨ Features

🚀 One-command setup: Install everything with a single script
🔄 Idempotent: Safe to run multiple times without side effects
🧩 Modular: Install only what you need by category
🤖 AI-powered: Local LLMs, AI coding tools, and intelligent editors
📚 Comprehensive documentation: Auto-generated complete setup documentation
🛡️ Production-ready: CI/CD, linting, security scanning, and error handling
⚙️ Highly configurable: YAML-driven configuration system
🌍 Complete environment: 50+ environment variables for seamless development
📁 Full dotfile management: Shell, Git, SSH, and editor configurations
🔌 VS Code extensions: 20+ essential extensions automatically installed
💻 Modern terminals: AI-powered Warp, iTerm2, Alacritty, WezTerm, Kitty
🚀 Services management: Database, AI, and development services with ports
🖥️ macOS optimization: Automatic system preferences configuration for optimal development experience

🚀 Quick Start

Option 1: Use a Preset Configuration (Recommended)

# Clone the repository
git clone https://github.com/davidsilvestrehenao-hub/env-setup.git
cd env-setup
Choose a configuration that fits your needs
./setup-env.sh install --config configs/webdev.yaml      # Web development
./setup-env.sh install --config configs/ai.yaml          # AI/ML development
./setup-env.sh install --config configs/minimal.yaml     # Essential tools only
./setup-env.sh install --config configs/everything.yaml  # Complete setup
Or preview first
./setup-env.sh preview --config configs/webdev.yaml

Option 2: Use Default Configuration

# Clone and run with default config
git clone https://github.com/davidsilvestrehenao-hub/env-setup.git
cd env-setup
./setup-env.sh install
Or preview first
./setup-env.sh preview

Option 3: Create Custom Configuration

# Copy a preset as starting point
cp configs/webdev.yaml configs/my-custom.yaml
Edit to your needs
nano configs/my-custom.yaml
Use your custom config
./setup-env.sh install --config configs/my-custom.yaml

⚙️ Configuration System

This tool is highly configurable with 10+ preset configurations for different user types:

| Configuration | Description | Packages | Perfect For | |---------------|-------------|----------|-------------| | everything | Complete setup with all packages | 113+ | Power users, new Mac setups | | minimal | Essential tools only | ~20 | Quick setup, basic development | | webdev | Web development focused | ~50 | Frontend/backend developers | | ai | AI/ML development | ~60 | AI researchers, data scientists | | mobile | Mobile development | ~50 | iOS/Android developers | | devops | DevOps & infrastructure | ~80 | DevOps engineers, SREs | | design | Design & creative tools | ~30 | UI/UX designers, creators | | gaming | Gaming & entertainment | ~30 | Gamers, streamers | | student | Student & learning | ~50 | Students, bootcamp participants | | senior | Senior developer tools | ~90 | Senior devs, tech leads |

🎯 Choose Your Configuration

New to development? → Start with minimal or student
Web developer? → Use webdev or everything
AI/ML work? → Choose ai or senior
DevOps engineer? → Go with devops or everything
Want everything? → Use everything (default)

📁 Configuration Files

All configurations are in the configs/ directory. Each file:

Extends the main config.yaml for base settings
Overrides specific package categories
Can be customized further for your needs
Serves as an example for creating your own configs

📦 What's Included

Core Development Tools

Version Control: Git, GitHub CLI
Runtimes: Node.js, Bun, Python
Package Managers: pnpm, Yarn, pipx
Containers: Docker, Colima
Databases: PostgreSQL, MongoDB, Redis, SQLite, ClickHouse, DuckDB, OpenSearch
Terminal Tools: Starship, eza, bat, fzf, ripgrep, fd, zoxide
Terminal Apps: Warp (AI-powered), iTerm2, Alacritty, WezTerm, Kitty
Development: Pre-commit, ShellCheck, direnv, git-delta, gitleaks

AI Tools & Models

Local LLMs: Ollama with Llama2 and DeepSeek Coder 33B
Model Management: LM Studio for GUI model management
AI Editors: Void IDE, Cursor IDE with AI capabilities
APIs: OpenAI CLI for cloud AI access
Web UI: Open WebUI for local model interaction

Code Editors & Extensions

Editors: VS Code, Cursor, Void IDE
Terminals: Warp (AI-powered), iTerm2, Alacritty, WezTerm, Kitty
Extensions: 30+ essential extensions for TypeScript, React, Vue, Docker, Kubernetes, and more
AI Integration: GitHub Copilot, AI-powered code completion

Productivity & Business Apps

Communication: WhatsApp, Signal, Telegram, Slack, Discord
Note-taking: Notion, Obsidian
Productivity: Raycast, Rectangle, MeetingBar, AltTab
Media: VLC, HandBrake, Spotify
Utilities: Keka, AppCleaner, Hidden Bar, MonitorControl, Stats

🎯 Installation Options

Using Setup Script (Easiest)

# Full installation
./setup-env.sh install
Preview installation
./setup-env.sh preview
Install specific categories
./setup-env.sh core        # Core development tools
./setup-env.sh frontend    # Frontend tools and editors
./setup-env.sh backend     # Backend tools and databases
./setup-env.sh business    # Productivity and business apps
./setup-env.sh ai          # AI tools and models
Cleanup
./setup-env.sh cleanup
Help
./setup-env.sh help

Using Make (Advanced)

# Full installation
make install
Preview installation
make setup-dry-run
Category-specific installation
make setup-core      # Core development tools
make setup-frontend  # Frontend tools and editors
make setup-backend   # Backend tools and databases
make setup-business  # Productivity and business apps
make setup-ai        # AI tools and models
make setup-webui     # Web interfaces
Quick setups
make setup-minimal   # Minimal setup (core only)
make setup-dev       # Developer setup (core + frontend + backend)
make setup-ai-focused # AI-focused setup

Using Scripts Directly

# Full installation
./scripts/setup-env.sh
Dry run (preview only)
./scripts/setup-env.sh --dry-run
Install specific categories
./scripts/setup-env.sh --only core
./scripts/setup-env.sh --only frontend
./scripts/setup-env.sh --only backend
./scripts/setup-env.sh --only business
Advanced options
./scripts/setup-env.sh --skip-models    # Skip AI model downloads
./scripts/setup-env.sh --skip-webui     # Skip web UI setup
./scripts/setup-env.sh --config my-config.yaml  # Use custom config

⚙️ Configuration

The entire setup is driven by config.yaml, which serves as the single source of truth for:

Package lists by category
VS Code extensions by role
AI model configuration
Service port settings
Tool descriptions and documentation links

# Example configuration
categories:
  core:
    name: "Core Development Tools"
    enabled: true
packages:   core:     brew: ["git", "node", "docker"]     cask: []
extensions:   core: ["dbaeumer.vscode-eslint", "esbenp.prettier-vscode"]

📚 Documentation

Quick Start Guide - Get up and running in 5 minutes
Complete Setup Guide - Comprehensive documentation
Troubleshooting - Common issues and solutions
Environment Setup Complete - Auto-generated comprehensive documentation

What's in the Complete Documentation

113+ Packages - Complete list with descriptions and status
20+ VS Code Extensions - Essential development extensions
Complete Dotfiles - Shell, Git, SSH, and editor configurations
50+ Environment Variables - Development environment setup
AI Tools & Models - Local LLMs and AI development tools
Terminal Applications - Modern terminals with configurations
Services & Ports - Database, AI, and development services
macOS System Preferences - Automatic configuration of Dock, Finder, Keyboard, Trackpad, Display, and more

🛠️ Maintenance

Using Make

# Update packages
make update
Run health checks
make health-check
Clean up (remove everything)
make clean
Preview cleanup
make clean-dry-run
Check service status
make services-status
make ai-status
make db-status

Using Scripts

# Health checks
./scripts/setup.sh --dry-run
Cleanup
./scripts/cleanup.sh
Generate comprehensive documentation
./scripts/generate-csv-readme.sh

🔧 Development

Prerequisites

macOS (Intel or Apple Silicon)
Internet connection
Administrator access
At least 10GB free disk space

Development Workflow

# Install development dependencies
make install
Run tests and linting
make test
make lint
Generate comprehensive documentation
make docs
Run pre-commit hooks
make pre-commit