Files
dotfiles/docs/ONE_LINE_INSTALL.md
Eric Turner ce2b7e0194 fix: update all branch references from main to dev
Update all URLs and branch references throughout the documentation
to use 'dev' as the default branch instead of 'main'.

Files updated:
- README.md
- docs/ONE_LINE_INSTALL.md
- docs/WEB_INSTALL_PAGE.html

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-02 21:22:49 -06:00

5.6 KiB

One-Line Installation Guide

🚀 Super Easy Installation

The Magic Command

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:

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

curl -fsSL https://raw.git.turnersrus.com/razzam21/dotfiles/dev/install-web.sh | bash

Silent Installation (No Prompts)

curl -fsSL https://raw.githubusercontent.com/your-username/dotfiles/main/install-web.sh | DOTFILES_SILENT=true bash

Force Specific Profile

# 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)

curl -fsSL https://raw.githubusercontent.com/your-username/dotfiles/main/install-web.sh | DOTFILES_SKIP_OPTIONAL=true bash

🎮 After Installation

Verify Everything Works

# Check system status
dotstatus

# Check your profile
dotprofile

# Check installed packages
dotpkgs

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

Get Help

# Show all available commands
alias | grep dot

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

🔧 Troubleshooting One-Liners

If Installation Fails

# 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

# 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)

# 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

# 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

# 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

# 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)

# 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

## 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.*