{"id":32657287,"url":"https://github.com/simonvic/minerals.nvim","last_synced_at":"2026-04-20T14:02:27.115Z","repository":{"id":320643270,"uuid":"1082733994","full_name":"simonvic/minerals.nvim","owner":"simonvic","description":"My personal neovim colorscheme collection","archived":false,"fork":false,"pushed_at":"2025-10-25T12:42:40.000Z","size":6087,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-25T13:21:04.026Z","etag":null,"topics":["colorscheme","lua","neovim","neovim-colorscheme","neovim-colorschemes","neovim-plugin","neovim-theme","neovim-theme-dark","neovim-theme-light","neovim-theme-lua"],"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/simonvic.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":"2025-10-24T17:26:25.000Z","updated_at":"2025-10-25T12:42:44.000Z","dependencies_parsed_at":"2025-10-25T01:25:25.033Z","dependency_job_id":null,"html_url":"https://github.com/simonvic/minerals.nvim","commit_stats":null,"previous_names":["simonvic/colorscheme.nvim","simonvic/minerals.nvim"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/simonvic/minerals.nvim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonvic%2Fminerals.nvim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonvic%2Fminerals.nvim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonvic%2Fminerals.nvim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonvic%2Fminerals.nvim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simonvic","download_url":"https://codeload.github.com/simonvic/minerals.nvim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simonvic%2Fminerals.nvim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32050451,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6: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":["colorscheme","lua","neovim","neovim-colorscheme","neovim-colorschemes","neovim-plugin","neovim-theme","neovim-theme-dark","neovim-theme-light","neovim-theme-lua"],"created_at":"2025-10-31T12:01:09.006Z","updated_at":"2026-04-20T14:02:27.107Z","avatar_url":"https://github.com/simonvic.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"My personal collection of neovim colorschemes with treesitter and semantic\nhighlights support.\n\nAll colorschemes have a dark and light variant; the appropriate one will be\nused when you `set background=dark` or `set background=light` \n\n# Overview\n\nRuby dark\n![ruby_dark](screenshots/simonvic_ruby_dark.png)\n\nOpal dark\n![opal_dark](screenshots/simonvic_opal_dark.png)\n\nSilver light\n![silver_light](screenshots/simonvic_silver_light.png)\n\n\n## All variants\n\n\u003ctable\u003e\n\t\u003cthead\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003cth\u003eLight\u003c/th\u003e\n\t\t\t\u003cth\u003eDark\u003c/th\u003e\n\t\t\u003c/tr\u003e\u003c/thead\u003e\n\t\u003ctbody\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd colspan=\"2\" align=\"center\"\u003esimonvic_opal\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003e\u003cimg src=\"screenshots/simonvic_opal_light.png\"\u003e\u003c/td\u003e\n\t\t\t\u003ctd\u003e\u003cimg src=\"screenshots/simonvic_opal_dark.png\"\u003e\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd colspan=\"2\" align=\"center\"\u003esimonvic_ruby\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003e\u003cimg src=\"screenshots/simonvic_ruby_light.png\"\u003e\u003c/td\u003e\n\t\t\t\u003ctd\u003e\u003cimg src=\"screenshots/simonvic_ruby_dark.png\"\u003e\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd colspan=\"2\" align=\"center\"\u003esimonvic_ruby_monochrome\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003e\u003cimg src=\"screenshots/simonvic_ruby_monochrome_light.png\"\u003e\u003c/td\u003e\n\t\t\t\u003ctd\u003e\u003cimg src=\"screenshots/simonvic_ruby_monochrome_dark.png\"\u003e\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd colspan=\"2\" align=\"center\"\u003esimonvic_silver\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\t\u003ctr\u003e\n\t\t\t\u003ctd\u003e\u003cimg src=\"screenshots/simonvic_silver_light.png\"\u003e\u003c/td\u003e\n\t\t\t\u003ctd\u003e\u003cimg src=\"screenshots/simonvic_silver_dark.png\"\u003e\u003c/td\u003e\n\t\t\u003c/tr\u003e\n\t\u003c/tbody\u003e\n\u003c/table\u003e\n\n# Customization\n\nEach colorscheme is a lua module that returns a `Colorscheme` with which you\ncan `:build()` a new one using it as a base, and then `:apply()`\n\nFor example, creating a new `emerald` theme based on `ruby` is as simple as\n\n```lua\nrequire(\"simonvic.colorscheme.ruby\")\n\t:build({\n\t\tname = \"emerald\",\n\t\tpalette = {\n\t\t\taccent = \"#00ff00\"\n\t\t}\n\t})\n\t:apply()\n```\n\nYou can also override the `groups`\n\n```lua\nrequire(\"simonvic.colorscheme.ruby\")\n\t:build({\n\t\tname = \"emerald\",\n\t\tgroups = {\n\t\t\tKeyword = { fg = \"#00ff00\", bold = true }\n\t\t}\n\t})\n\t:apply()\n```\n\n\u003e [!TIP]\n\u003e To \"delete\" a field from a group, you can use an empty string\n\u003e ```lua\n\u003e DiffAdd = { bg = \"\" }\n\u003e ```\n\nIf you need to override the `palette` and use the resulting merged palette in\nthe `groups`, you can use a function that takes a palette and returns the\ngroups\n\n```lua\nrequire(\"simonvic.colorscheme.ruby\")\n\t:build({\n\t\tname = \"emerald\",\n\t\tpalette = {\n\t\t\taccent = \"#00ff00\"\n\t\t}\n\t\tgroups = function(palette)\n\t\t\treturn {\n\t\t\t\tKeyword = { fg = palette.accent, bold = true }\n\t\t\t}\n\t\tend\n\t})\n\t:apply()\n```\n\n# Rationale\n\nA `Colorscheme` is made of three things:\n\n- name\n- palette: abstract collection of colors\n- groups: actual highlight groups definitions\n\n## Palette\n\nA palette mainly consists in accent colors, UI component colors, text colors,\nmain syntax colors and some more\n\n- Accent colors represents your main favorite color shades.\n\n- UI components are treated as if they were \"overlaying layers\"; each layer has\na respective `zdepth_n` color\n\n- Most colors in a palette have some `+n` and `-n` shade variants (e.g.\n`accent_4` (+4), `accent__4` (-4)), where the `n` represents how much that\nshade of color blends with or stands out from the background.\n\n  For example, with a dark background, `accent__4` would be a very dark shade\nof `accent`, while `accent_2` a slightly bright shade of `accent`\n\n## Groups\n\nSyntax highlight groups follow some rules:\n\n- **keywords** are what stand out more from the background: they are the main\nelements that describe how your code is structured; if you were to squint your\neyes and look at a code snippet from far away, you should still be able to\ndistinguish a `for` loop statement from a `class` or `function` declaration\n\n- similar rationale for **punctuation**: for example, in an array or function\narguments list, you should easily recognize where each entry begins and ends.\n\n  *insert r/programmerhumor missing semicolon joke here*\n\n- keywords and punctuation, and therefore the structure of your code, should\nhave the same or similar color\n\n- **metakeywords**, such as preprocessor directives in C or annotations in\nJava, should have a very distinctive color from the rest of the code, as they\nshould feel extraneous to it.\n\n- **literals** (e.g. strings, numbers, booleans) should all have the same or a\nsimilar spectrum of color, that somewhat stands out from the rest of the code\n\n- **comments**: a possibly controversial take, but comments should blend more\nrather than standing out; 90% of the time you read code, and comments should\nnot hinder you when coding. Reading comments should be the exception.\n\n- same applies to **documentation** comments, albeit with a different shade of\nthe same color.\n\n  You probably read docs more than comments, but you usually do it in your\n  editor UI, which supposedly gives you a better experience by rendering\n  whatever markup language is used. Reading \"raw\" docs should be the exception.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonvic%2Fminerals.nvim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimonvic%2Fminerals.nvim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimonvic%2Fminerals.nvim/lists"}