{"id":16420392,"url":"https://github.com/philgyford/dotfiles","last_synced_at":"2026-05-18T04:03:13.349Z","repository":{"id":7886566,"uuid":"9263083","full_name":"philgyford/dotfiles","owner":"philgyford","description":"System config stuff","archived":false,"fork":false,"pushed_at":"2026-04-17T14:28:24.000Z","size":2274,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-17T16:32:54.552Z","etag":null,"topics":["dotfiles","shell"],"latest_commit_sha":null,"homepage":"","language":"Lua","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/philgyford.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2013-04-06T16:38:30.000Z","updated_at":"2026-04-17T14:28:27.000Z","dependencies_parsed_at":"2025-01-29T15:20:43.025Z","dependency_job_id":"a003e49e-22f6-4be4-a598-47087d81d4f6","html_url":"https://github.com/philgyford/dotfiles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/philgyford/dotfiles","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philgyford%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philgyford%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philgyford%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philgyford%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/philgyford","download_url":"https://codeload.github.com/philgyford/dotfiles/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/philgyford%2Fdotfiles/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33164672,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"online","status_checked_at":"2026-05-18T02:00:06.436Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["dotfiles","shell"],"created_at":"2024-10-11T07:27:54.620Z","updated_at":"2026-05-18T04:03:13.344Z","avatar_url":"https://github.com/philgyford.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# dotfiles\n\nMy system config stuff. Includes Neovim config (in `.config/nvim/`).\n\nSwitched from using bash to zsh in 2020, so the bash files probably won't\nget many updates from here on.\n\nFor each of the files/folders do something like:\n\n    $ ln -s ~/Projects/personal/dotfiles/filename ~/.filename\n\n--\n\n## Neovim\n\n    $ ln -s ~/Projects/personal/dotfiles/.config/nvim ~/.config/nvim\n    $ ln -s ~/Projects/personal/dotfiles/.config/nvim/lsp ~/.config/nvim/lsp\n    $ ln -s ~/Projects/personal/dotfiles/.config/nvim/init.lua ~/.config/nvim/init.lua\n\nI also had to install at least these things using Homebrew, for various plugins:\n\n    $ brew install ripgrep\n    $ brew install fzf\n    $ brew install tree-sitter-cli\n    $ brew install npm  # For emmet-language-server and biome\n    $ brew install stylua  # For conform to format lua files\n\nAnd then:\n\n    $ npm install -g @olrtg/emmet-language-server\n    $ npm install -g @biomejs/biome\n\nAnd after installing the plugins, including Telescope, we *might* need to\nmanually do this build step for its optional fzf plugin:\n\n    $ cd ~/.local/share/nvim/site/pack/core/opt/telescope-fzf-native.nvim\n    $ make\n\n### Plugins\n\n#### Add a new plugin\n\n1. Create a new file in `.config/nvim/lua/plugins/`. This should call\n   `vim.pack.add()` on the repository URL, and then probably do at least\n   `require(\"\u003cPLUGIN\u003e\").setup()`.\n2. Then `require()` that file from `.config/nvim/lua/plugins/init.lua`.\n3. Either re-open neovim or do `:restart`.\n\n#### Update plugins\n\nDo `:lua vim.pack.update()` or shortcut `\u003cleader\u003epu` to update all plugins.\n\n#### Remove a plugin\n\nDo `:lua vim.pack.del({\"plugin-name\"})`. (And delete file from `plugins`\nfolder?)\n\n### Checking things are OK\n\nDo `:checkhealth` to get a full report of any problems, or `:checkhealth\n\u003cplugin\u003e` for a specific plugin's.\n\n### Adding support for different languages / file types\n\n#### 1. Add a language server\n\n1. Add a config file for it in `.config/nvim/lsp/`. See examples [at\n   nvim-lspconfig](https://github.com/neovim/nvim-lspconfig/blob/master/doc/configs.md)\n3. Use `:MasonInstall \u003cname\u003e` to install the language server.\n\n#### 2. Add treesitter support\n\n1. Ensure it's listed in `file_types` in\n   `.config/nvim/lua/pluings/treesitter.lua`.\n\nWhen you first open a file of a new type, there might be an error but\nnvim-treesitter should then automatically install the new parser. You may\nneed to reload the file in question again.\n\nOr manually install a new parser with `:TSInstall \u003cparser\u003e`.\n\nDiagnose problems with `:checkhealth vim.lsp`\n\n---\n\n## VS Code\n\nYou should do something like this:\n\n    $ ln -s ~/Projects/personal/dotfiles/vscode/keybindings.json ~/Library/Application\\ Support/Code/User/keybindings.json\n    $ ln -s ~/Projects/personal/dotfiles/vscode/settings.json ~/Library/Application\\ Support/Code/User/settings.json\n\n--\n\n## Starship prompt\n\n    $ ln -s ~/Projects/personal/dotfiles/.config/starship.toml ~/.config/starship.toml\n\n--\n\n## Other old notes\n\nFor Atom, you should also install the \"package-sync\" Package, which will read\nyour `.atom/packages.cson` file and install the necessary Packages. \n\n--\n\n- Phil Gyford\n- phil@gyford.com\n- https://www.gyford.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilgyford%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphilgyford%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphilgyford%2Fdotfiles/lists"}