This repository provides a curated set of personal dotfiles designed to create a modern, fast, and efficient shell environment, particularly optimized for Laravel/PHP development. It targets developers seeking a streamlined setup with version-controlled configurations, leveraging contemporary CLI tools and smart navigation for enhanced productivity. The primary benefit is a pre-configured, high-performance development workspace.

How It Works

The setup employs a symlinking strategy, connecting configuration files within the repository to their standard locations in the user's home directory. It relies on Homebrew for package management, fnm for Node.js version control, and Oh My Zsh for Zsh shell configuration, featuring a custom Agnoster theme. Core components include speed-optimized, Rust-based utilities like zoxide for directory navigation and ripgrep for searching, alongside integrations for Claude Code skills and agents.

Quick Start & Requirements

• Primary Install: Clone the repository and run the bin/install script:

  git clone git@github.com:freekmurze/dotfiles.git ~/.dotfiles
  cd ~/.dotfiles
  bin/install
  

• Prerequisites: macOS operating system, Homebrew package manager, and Nerd Fonts for icon support.
• Dependencies: Node.js (LTS managed by fnm), PHP, Composer, MySQL, and Laravel Valet.
• Links: Repository: https://github.com/freekmurze/dotfiles

Highlighted Details

• Custom Agnoster Theme: A clean, powerline-style Zsh prompt with minimal symbols for improved readability.
• Performance-Oriented Tooling: Integrates fast, Rust-based CLI tools such as zoxide, ripgrep, bat, eza, fd, and fnm.
• Developer Productivity: Features smart directory navigation (zoxide), fuzzy file/history search (fzf), and numerous shortcuts for Laravel/PHP development workflows.
• Claude Code Integration: Version-controlled Claude Code skills and agents, with a standalone installer available.

Maintenance & Community

This project is maintained by Freek Van der Herten and used by developers at Spatie. An bin/update script is provided for updating core tools and packages. No explicit community channels (e.g., Discord, Slack) are listed.

Licensing & Compatibility

The repository's license is not explicitly stated in the provided README. Compatibility is primarily geared towards macOS due to its reliance on Homebrew.

Limitations & Caveats

The setup is heavily tailored for macOS environments. The absence of a clearly defined license is a significant caveat for potential adoption, especially in commercial contexts.