dotfiles/docs/ONE_LINE_INSTALL.md

# One-Line Installation Guide

## 🚀 Super Easy Installation

### The Magic Command
```bash
curl -fsSL https://raw.git.turnersrus.com/razzam21/dotfiles/dev/install-web.sh | bash
```

**That's it!** Copy, paste, and press Enter. Your intelligent dotfiles system will be ready in 30 seconds.

## 🎯 What This Command Does

1. **Downloads** the web installer script
2. **Auto-detects** your machine type (server/dev/personal)
3. **Installs** appropriate packages for your profile
4. **Configures** universal aliases and shortcuts
5. **Sets up** automatic syncing and updates

## 🛡️ Security First

Before running any script from the internet, you should review it:

**View the installer script:**
```bash
curl -fsSL https://raw.githubusercontent.com/your-username/dotfiles/main/install-web.sh
```

**What the script does:**
- ✅ Only installs from trusted package repositories
- ✅ Creates backups before making changes
- ✅ Uses standard package managers (apt, npm, brew)
- ✅ No hidden or obfuscated code
- ✅ All operations logged for transparency

## 📱 Copy-Paste Ready Commands

### For Different Scenarios

#### Standard Installation (Recommended)
```bash
curl -fsSL https://raw.git.turnersrus.com/razzam21/dotfiles/dev/install-web.sh | bash
```

#### Silent Installation (No Prompts)
```bash
curl -fsSL https://raw.githubusercontent.com/your-username/dotfiles/main/install-web.sh | DOTFILES_SILENT=true bash
```

#### Force Specific Profile
```bash
# Server profile
curl -fsSL https://raw.githubusercontent.com/your-username/dotfiles/main/install-web.sh | DOTFILES_PROFILE=server bash

# Development profile
curl -fsSL https://raw.githubusercontent.com/your-username/dotfiles/main/install-web.sh | DOTFILES_PROFILE=dev bash

# Personal profile
curl -fsSL https://raw.githubusercontent.com/your-username/dotfiles/main/install-web.sh | DOTFILES_PROFILE=personal bash
```

#### Skip Optional Packages (Faster)
```bash
curl -fsSL https://raw.githubusercontent.com/your-username/dotfiles/main/install-web.sh | DOTFILES_SKIP_OPTIONAL=true bash
```

## 🎮 After Installation

### Verify Everything Works
```bash
# Check system status
dot sync status

# Check your profile
dot profile

# Check installed packages
dot packages

# Try some shortcuts
l              # Enhanced file listing
g              # Git shortcut
..             # Go up directory
```

### Get Help
```bash
# Show all available commands
alias | grep dot

# Read documentation
cat ~/.dotfiles/docs/README.md
```

## 🔧 Troubleshooting One-Liners

### If Installation Fails
```bash
# Check what went wrong
cat ~/.dotfiles/.package.log

# Try installing packages manually
cd ~/.dotfiles && ./install.sh

# Reset and try again
cd ~/.dotfiles && ./reset.sh --soft && ./install.sh
```

### If Network Issues
```bash
# Install without GitHub packages
curl -fsSL https://raw.githubusercontent.com/your-username/dotfiles/main/install-web.sh | DOTFILES_SKIP_GITHUB=true bash

# Install without npm packages
curl -fsSL https://raw.githubusercontent.com/your-username/dotfiles/main/install-web.sh | DOTFILES_SKIP_NPM=true bash
```

### Manual Installation (If curl fails)
```bash
# Clone and install manually
git clone https://git.turnersrus.com/razzam21/dotfiles ~/.dotfiles
cd ~/.dotfiles && chmod +x install.sh && ./install.sh
```

## 📋 Platform-Specific One-Liners

### Ubuntu/Debian
```bash
# Install prerequisites and dotfiles
sudo apt update && sudo apt install -y curl git && curl -fsSL https://raw.git.turnersrus.com/razzam21/dotfiles/dev/install-web.sh | bash
```

### CentOS/RHEL
```bash
# Install prerequisites and dotfiles
sudo yum install -y curl git && curl -fsSL https://raw.git.turnersrus.com/razzam21/dotfiles/dev/install-web.sh | bash
```

### macOS
```bash
# Install Xcode tools and dotfiles (if needed)
xcode-select --install 2>/dev/null || true && curl -fsSL https://raw.git.turnersrus.com/razzam21/dotfiles/dev/install-web.sh | bash
```

### WSL (Windows)
```bash
# Same as Ubuntu (WSL uses Ubuntu packages)
curl -fsSL https://raw.git.turnersrus.com/razzam21/dotfiles/dev/install-web.sh | bash
```

## 🌐 Web Page for Easy Copying

For the ultimate user experience, host the `WEB_INSTALL_PAGE.html` on your website. Users can then:

1. **Visit** your installation page
2. **Click** the copy button
3. **Paste** into their terminal
4. **Enjoy** their new dotfiles system

### Example hosting locations:
- `https://your-domain.com/dotfiles`
- `https://your-username.github.io/dotfiles`
- GitHub Pages, Netlify, Vercel, etc.

## 🚀 Marketing-Ready Copy-Paste

### For Social Media
```
🚀 Transform your terminal in 30 seconds!

One command installs an intelligent dotfiles system that adapts to your machine type:
• Servers get minimal tools
• Dev machines get AI assistants
• Same shortcuts everywhere

curl -fsSL https://your-domain.com/install | bash

#dotfiles #terminal #productivity
```

### For README/Documentation
```markdown
## Quick Start

```bash
curl -fsSL https://your-domain.com/install | bash
```

This command will:
- Auto-detect your machine type
- Install appropriate tools
- Set up universal shortcuts
- Configure automatic updates
```

### For Email Signatures
```
P.S. Want a better terminal experience? Try: curl -fsSL https://your-domain.com/install | bash
```

## 💡 Tips for Maximum Adoption

1. **Use a short URL**: `your-domain.com/install` is easier to remember
2. **Host the HTML page**: Visual instructions increase confidence
3. **Include security note**: Shows you care about user safety
4. **Provide multiple options**: Silent, profile-specific, etc.
5. **Make it copyable**: Big copy buttons, clear commands

---

*One command. Infinite possibilities. Your new terminal experience is just a paste away.*