configuration

Personal system configuration repository for macOS and Linux machines.

About • Supported Platforms • Installation & Setup • Repository Structure • Safety & Assumptions

About

This repository contains scripts, dotfiles, and documentation used to:

• Set up new computers from scratch
• Rebuild a system after failure or replacement
• Maintain a consistent development environment across machines
• Serve as a centralized backup of system preferences and tools
• Automated installation of GUI and CLI applications
• Centralized management of dotfiles
• OS-specific configuration (macOS and Linux)
• Font management
• Shell, Git, and editor configuration
• Idempotent scripts (safe to re-run)

The repository contains two sub directories for specific scripts and settings for macOS and Ubuntu.

Supported Platforms

• macOS Tahoe 26.5 (MacBook Pro M1)
• Ubuntu 26.04, and most Debian based distros

Installation & Setup

Download the repository as a zip folder

Requirements

• Xcode: macOS only!

git clone git@github.com:tafaranyamhunga/configuration.git
cd configuration/ # Or configuration-main

./setup.sh

Repository Structure

A collection of setup scripts, configuration files, and dotfiles used to automate the provisioning of new development environments on macOS and Ubuntu systems.

Path	Description
assets	Project assets.
docs	This directory contains all project documentation for the configuration repository.
shared	Shared assets across the two systems.
macOS Tahoe 26.5	macOS specific setup scripts and dotfiles.
Ubuntu 26.04	Ubuntu specific setup scripts and dotfiles.

Safety & Assumptions

• Scripts are designed for personal use!!
• Some scripts may overwrite existing dotfiles.
• Review scripts before running on production systems.

Licensing

All files, unless otherwise stated, are licensed under the MIT License. A copy of the license can be found in the LICENSE file.