Setup Configuration

A modular configuration bank for building reproducible development environments across platforms.

This repository provides automated setup scripts and dotfiles for macOS, Ubuntu Server, and Windows, enabling consistent development environments with a single command.

Quick Start

Bootstrap your entire development environment with one command:

macOS

curl -fsSL https://raw.githubusercontent.com/ZiedYousfi/myconfig/main/bootstrap.sh | bash -s -- macos

Ubuntu Server

curl -fsSL https://raw.githubusercontent.com/ZiedYousfi/myconfig/main/bootstrap.sh | bash -s -- ubuntu

Windows (cmd.exe)

powershell -NoProfile -ExecutionPolicy Bypass -Command "& { $p = Join-Path $env:TEMP 'bootstrap.ps1'; Invoke-WebRequest 'https://raw.githubusercontent.com/ZiedYousfi/myconfig/main/bootstrap.ps1' -OutFile $p; Unblock-File $p; & $p }"

Interactive Mode (Auto-detect or Choose)

/!\ This does not work on Windows. Use the Windows command above instead.

curl -fsSL https://raw.githubusercontent.com/ZiedYousfi/myconfig/main/bootstrap.sh | bash

The bootstrap script will:

1. Download the latest release
2. Extract all configuration files
3. Run the appropriate platform installer
4. Set up dotfiles using GNU Stow (macOS/Ubuntu) or copy to Windows locations
5. Install all necessary tools and packages

Features

• Idempotent: Safe to run multiple times without side effects
• Modular: Shared dotfiles with platform-specific additions
• Automated: Installs all dependencies and tools
• Documented: Full specifications in SPECS.md
• Backed Up: Automatically backs up existing configurations

Uninstalling

Each platform has an uninstall script:

./macos/uninstall.sh          # macOS
./ubuntu-server/uninstall.sh  # Ubuntu Server
./windows/uninstall.ps1       # Windows (PowerShell)

Documentation

See SPECS.md for complete configuration specifications and details about all installed components.

Requirements

Minimal requirements - the bootstrap script handles everything else:

macOS/Ubuntu:

• curl - for downloading
• Internet connection

Windows:

• Winget (pre-installed on Windows 10 1709+)
• Internet connection