jimseven / dotfiles

.files is a collection of configuration files (dotfiles duh!) plus an automated setup to install all the apps and tools to get you running in no time.

.files

🚀 A development setup in just a few minutes without the hassle

So you got a new 💻 or you just want to do a clean install of the latest macOS but don't have much time setting everything up the way you like it? Well, meet .files!

.files is a collection of configuration files (dotfiles duh!) plus an automated setup to install all the apps and tools to get running in no time.

🤖 Automated installation

⚠️ Please backup your current settings. They may very well be overwritten!

After you've successfully installed macOS you can just copy & paste this line into the terminal:

curl -fsSL https://raw.githubusercontent.com/jimseven/dotfiles/main/scripts/remote-install.sh | bash

🐢 Manual installation

⚠️ Please backup your current settings. They may very well be overwritten!

💡 macOS Command Line Tools are required. You can install them with:

xcode-select --install

1. Clone this repo

   git clone [email protected]:jimseven/dotfiles.git
   

2. Install

   make install
   

🧐 So what the hell is going on?

Programming language utilities and package managers

• Homebrew is a package manager that simplifies the installation of software on Apple's macOS operating system and Linux
• Git - Even though it is shipped with macOS, the shipped version is often not up to date.
• Volta's job is to manage your JavaScript command-line tools, such as node, npm, yarn, or executables shipped as part of JavaScript packages. It is similar to NVM but faster.

Terminal Tools

• iTerm2 is a replacement for Terminal. It is super fast and looks great.

• iTerm2 Material Design is an iTerm2 color scheme based on Google's Material Design Color Palette.

• Oh My Zsh is a framework for managing your Zsh configuration.

• Powerlevel10k is a theme for Zsh. It emphasizes speed, flexibility and out-of-the-box experience.

• Antigen is a small set of functions that help you easily manage your shell (zsh) plugins. It makes installing and integrating zsh plugins super easy.

• Command Not Found reproduces Ubuntu’s command-not-found for Homebrew users on macOS. When you try to use a command that doesn’t exist locally but is available through a package, it will suggest you a command to install it.

• z - jump around defines the z command that tracks your most visited directories and allows you to access them with very few keystrokes.

• zsh-autosuggestions suggests commands as you type based on history and completions.

• zsh-completions are additional completion definitions for Zsh.

• zsh-syntax-highlighting provides syntax highlighting for the shell zsh. It enables highlighting of commands whilst they are typed at a zsh prompt into an interactive terminal.

Dev Ops

• Docker allows you to build, test, and deploy applications quickly. It packages software into standardized units called containers that have everything the software needs to run including libraries, system tools, code, and runtime. You can quickly deploy and scale applications into any environment and know your code will run.

• TablePlus is a GUI tool for several relational databases including MySQL, PostgreSQL, SQLite & more.

IDE

• Visual Studio Code was ranked the most popular developer environment tool and that rightfully so.

• Material Neutral Theme is a theme for VS Code that is based on Google's Material Design Color Palette.

• Material Icon Theme gets the Material Design icons into VS Code.

• VSCode GraphQL aims to tightly integrate the GraphQL ecosystem with VSCode for an awesome developer experience.

• Docker for Visual Studio Code makes it easy to build, manage, and deploy containerized applications from Visual Studio Code.

• Rainbow CSV highlights CSV and TSV spreadsheet files in different rainbow colors.

• YAML Language Support by Red Hat provides comprehensive YAML Language support to Visual Studio Code, via the yaml-language-server, with built-in Kubernetes syntax support.

Productivity Tools

• 1Password provides a place for users to store various passwords, software licenses, and other sensitive information in a virtual vault that is locked with a PBKDF2-guarded master password.

• Google Drive File Stream allows easy access to Google Drive files and folders without using a web browser.

• Notion is an all-in-one workspace application that provides components such as databases, kanban boards, wikis, calendars and reminders for the whole team.

• Slack is a channel-based messaging platform.

Browsers

• Chrome is most likely the browser with the highest market share world wide across all platforms.

• Firefox Developer Edition is tailored for web developers.

Audio & Video

• IINA is a lightweight media player based on mpv and designed with modern versions of macOS in mind.

macOS utilities

• Dockutil is a command line utility for managing macOS dock items.

• Keka is a full featured file archiver.

• mas-cli is simple command line interface for the Mac App Store that is designed for scripting and automation.

• Finicky is a macOS application that allows you to set up rules that decide which browser is opened for every link or url.

References

• Makefile for your dotfiles - Mark Nielsen
• Mathias’s dotfiles - Mathias Bynens
• .files - Lars Kappert
• Dotfiles - Martijn Gastkemper
• Matt's MacOS dotfiles - Matt Smith
• macOS defaults list - Yann Bertrand