README.md

.files

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

Got a new 💻 or planning a clean install of the latest macOS but short on time to set everything up? Meet .files!

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

🤖 Automated installation

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

After installing macOS, copy & paste this line into the terminal:

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

🐢 Manual installation

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

💡 macOS Command Line Tools are required. Install them with:

xcode-select --install

1. Clone this repo:

git clone git@github.com:robocopklaus/dotfiles.git

2. Install:

make install

🧐 What's included?

Programming language utilities and package managers

• Homebrew: Simplifies software installation on macOS and Linux.
• Git: Often more up-to-date than the version shipped with macOS.
• Volta: Manages JavaScript command-line tools like node, npm, and yarn.

Terminal Tools

• iTerm2: A fast and visually appealing Terminal replacement.
• Antidote: A faster and simpler Zsh plugin manager.
• Command Not Found: Suggests commands to install missing packages.
• z - jump around: Tracks and quickly accesses your most visited directories.
• zsh-autosuggestions: Suggests commands as you type.
• zsh-completions: Additional completion definitions for Zsh.
• zsh-syntax-highlighting: Syntax highlighting for Zsh.

DevOps

• Docker: Packages software into containers for quick deployment and scaling.

IDE

• Visual Studio Code: Popular developer environment tool.
• Material Neutral Theme: VS Code theme based on Material Design.
• Material Icon Theme: Brings Material Design icons to VS Code.
• Docker for Visual Studio Code: Manages containerized applications from VS Code.
• Rainbow CSV: Highlights CSV and TSV files in different colors.
• Dotenv: Support for .env files.
• GitHub Copilot: AI pair programmer.
• GitHub Copilot Chat: Chat with GitHub Copilot.
• Indent Rainbow: Makes indentation more readable.

Productivity Tools

• 1Password: Securely stores passwords and sensitive information.
• Google Drive: Access Google Drive files without a web browser.
• Notion: All-in-one workspace for databases, kanban boards, wikis, and more.
• Slack: Channel-based messaging platform.
• Clockify: Time tracking software.
• Herd: A one-click PHP development environment with zero dependencies and zero headaches.
• Kap: Open-source screen recorder.
• Postman: API development environment.
• Sketch: Digital design toolkit.
• TablePlus: Modern, native tool for database management.
• WhatsApp: Messaging app.
• Home Assistant: Open-source home automation platform.
• Mimestream: Native macOS email client for Gmail.
• ChatGPT: AI chatbot.

Browsers

• Chrome: Browser with the highest market share worldwide.
• Firefox Developer Edition: Tailored for web developers.

Audio & Video

• IINA: Lightweight media player based on mpv.
• Spotify: Digital music service.

macOS utilities

• Dockutil: Command line utility for managing macOS dock items.
• mas-cli: Command line interface for the Mac App Store.
• Finicky: Sets up rules to decide which browser opens for each link.

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