{"id":44748377,"url":"https://github.com/phoinixi/dotfiles","last_synced_at":"2026-02-15T22:19:09.686Z","repository":{"id":79641535,"uuid":"103975256","full_name":"phoinixi/dotfiles","owner":"phoinixi","description":"dotfiles for frontend development in Mac os X, includes oh-my-zsh, vscode settings and git aliases and several utilities","archived":false,"fork":false,"pushed_at":"2025-04-17T22:31:55.000Z","size":49,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-18T12:00:47.758Z","etag":null,"topics":["brewfile","dotfiles","frontend-development","macos-setup","vscode","zsh"],"latest_commit_sha":null,"homepage":"https://francescoesposito.dev/blog/developer-dotfiles-guide/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/phoinixi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"phoinixi","custom":"https://paypal.me/fraesposi"}},"created_at":"2017-09-18T18:18:53.000Z","updated_at":"2025-04-17T22:31:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"f06aaf39-b822-4f7b-89e4-1ce0e909f36d","html_url":"https://github.com/phoinixi/dotfiles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/phoinixi/dotfiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phoinixi%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phoinixi%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phoinixi%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phoinixi%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/phoinixi","download_url":"https://codeload.github.com/phoinixi/dotfiles/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/phoinixi%2Fdotfiles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29490551,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T19:29:10.908Z","status":"ssl_error","status_checked_at":"2026-02-15T19:29:10.419Z","response_time":118,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["brewfile","dotfiles","frontend-development","macos-setup","vscode","zsh"],"created_at":"2026-02-15T22:19:09.273Z","updated_at":"2026-02-15T22:19:09.680Z","avatar_url":"https://github.com/phoinixi.png","language":"Shell","funding_links":["https://github.com/sponsors/phoinixi","https://paypal.me/fraesposi"],"categories":[],"sub_categories":[],"readme":"#  macOS Dotfiles for Frontend Development\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nThis repository contains personal configuration files (dotfiles) optimized for a macOS frontend development environment. It sets up Zsh with Oh My Zsh, installs useful tools and applications via Homebrew, configures Git, and applies various macOS settings.\n\n## Features\n\n- **Shell:** Zsh + Oh My Zsh with useful plugins (`git`, `node`, `npm`, `yarn`, `pnpm`, `docker`, `z`, etc.).\n- **Package Management:** Uses [Homebrew](https://brew.sh/) and `brew bundle` to manage CLI tools and GUI applications (`Brewfile`).\n- **Node.js Management:** Uses [fnm](https://github.com/Schniz/fnm) for Node.js version management.\n- **Git Configuration:** Sensible defaults and useful aliases (`git/.gitconfig`, `git/.gitignore_global`).\n- **Editor Configuration:** Basic editor consistency via `.editorconfig`.\n- **macOS Settings:** Customizes macOS defaults for Finder, Dock, keyboard, screenshots, and more via scripts in the `osx/` directory (Use with caution, review `osx/utility.sh` and `osx/dock.sh`).\n- **Installation Script:** Provides an idempotent `install.sh` script to set up Homebrew, install dependencies, and create necessary symlinks.\n\n## Prerequisites\n\n- macOS\n- Git (for cloning)\n\n## Installation\n\n1.  **Clone the repository:**\n\n    ```bash\n    git clone https://github.com/phoinixi/dotfiles.git ~/.dotfiles\n    ```\n\n    _(Using `~/.dotfiles` is a common convention, but you can choose another location)_\n\n2.  **Run the installation script:**\n    ```bash\n    cd ~/.dotfiles\n    ./install.sh\n    ```\n\nThe script will:\n\n- Install Homebrew if it's not already present.\n- Install all packages and applications listed in the `Brewfile`.\n- Install Oh My Zsh if it's not already present.\n- Create symbolic links from your home directory (`~/`) to the configuration files in this repository (e.g., `~/.zshrc` -\u003e `~/.dotfiles/.zshrc`). Existing files will be backed up (e.g., `~/.zshrc.bak`).\n- Install the LTS version of Node.js using `fnm`.\n- Apply macOS settings defined in the `osx/` directory.\n\n3.  **Restart your terminal:** Open a new terminal window/tab or run `source ~/.zshrc` for all changes to take effect.\n\n4.  **(Manual Step) Configure Git User:** Set your Git user name and email globally:\n    ```bash\n    git config --global user.name \"Your Name\"\n    git config --global user.email \"your.email@example.com\"\n    ```\n\n## Key Software Included (via Brewfile)\n\n- **CLI Tools:** `fzf`, `ripgrep`, `bat`, `eza`, `httpie`, `jq`, `watchman`, `gh`, `coreutils`, etc.\n- **Frontend:** `fnm`, `pnpm`.\n- **Apps:** `hyper`, `visual-studio-code`, `cursor`, `brave-browser`, `google-chrome`, `raycast`, `docker`, `slack`, `telegram`, `whatsapp`, etc. (Check `Brewfile` for the full list).\n\n## Customization\n\n- **Brewfile:** Add or remove packages/casks by editing the `Brewfile` and re-running `brew bundle install --file=~/.dotfiles/Brewfile`.\n- **Zsh:** Add custom aliases, functions, or change plugins/theme in `.zshrc`.\n- **Git:** Modify `git/.gitconfig` for different Git settings.\n- **macOS Settings:** Edit scripts in the `osx/` directory (carefully review changes, especially in `utility.sh`). Remove the call to `source index.sh` in `install.sh` if you don't want these settings applied.\n\n## Structure Overview\n\n```\n.\n├── Brewfile            # Homebrew packages and applications\n├── Brewfile.lock.json  # Generated by brew bundle\n├── README.md           # This file\n├── .editorconfig       # Editor code style consistency\n├── .zshrc              # Main Zsh configuration (sources OMZ, sets options, aliases)\n├── git/\n│   ├── .gitconfig        # Git configuration (symlinked to ~/.gitconfig)\n│   └── .gitignore_global # Source for global gitignore\n├── install.sh          # Installation and setup script\n├── osx/                # macOS customization scripts\n│   ├── index.sh        # Main script applying macOS settings\n└── utils/              # Helper scripts for install.sh\n    └── utils.sh\n```\n\n## Contributing / Issues\n\nFound a bug or want a new feature? Please [create an issue](https://github.com/phoinixi/dotfiles/issues/new).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphoinixi%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphoinixi%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphoinixi%2Fdotfiles/lists"}