Skip to content

macOS environment setup; compatible up to macOS Ventura (^13.0)

License

Notifications You must be signed in to change notification settings

ruchernchong/dotfiles

Repository files navigation

dotfiles

This repository contains dotfiles and scripts that I use to customize my macOS/Linux development workflow. Feel free to use this as a reference for your own setup.

Terminal

Table of Contents

Features

  • Installs Oh-My-Zsh by default
  • Comprehensive git aliases for daily use
  • Customized oh-my-zsh settings
  • Automated setup script

System Requirements

Supported Platforms

  • macOS (10.15+)
  • Linux (Ubuntu 20.04+, Fedora 33+)

Prerequisites

  • Zsh
  • Git
  • Homebrew (macOS)
  • curl

Configurations

Zsh Customizations

  • Custom Oh-My-Zsh theme configuration
  • Key plugins:
    • zsh-autosuggestions
    • zsh-syntax-highlighting
    • git
    • docker

Git Aliases

  • ggit
  • gpgit pull
  • gpsgit push
  • Custom commit and branch management shortcuts

Installation

Warning: Do not blindly use these settings as they may override or modify your existing configuration. It is highly recommended to clone/fork this repository to another folder. Use at your own risk!

OTA Installation

curl -L https://raw.githubusercontent.com/ruchernchong/dotfiles/master/install.sh | bash

Cloning the Repository

git clone https://github.com/ruchernchong/dotfiles.git $HOME/dotfiles
cd $HOME/dotfiles
chmod a+x setup.sh
source setup.sh

# Set up Git Hooks
git config core.hooksPath .githooks
chmod +x .githooks/post-push

Git Hooks Setup

This repository includes a post-push hook for automatically updating and committing the Brewfile:

  • Located in .githooks/post-push
  • Automatically runs brew bundle dump
  • Stages and commits Brewfile changes
  • Requires manual activation after cloning

To enable the hook:

git config core.hooksPath .githooks
chmod +x .githooks/post-push

Feedback

I welcome any feedback or suggestions by creating an issue or a pull request.

License

This code is available under the MIT License