{"id":51634338,"url":"https://github.com/jerryaugusto/vitrea.nvim","last_synced_at":"2026-07-13T12:02:34.516Z","repository":{"id":365703569,"uuid":"1271746553","full_name":"jerryaugusto/vitrea.nvim","owner":"jerryaugusto","description":"The architecture of silence. A monastic color paradigm for Neovim engineered to eradicate visual entropy, isolate the intellect, and impose Order upon logic. Ordo et Silentium.","archived":false,"fork":false,"pushed_at":"2026-06-18T12:58:22.000Z","size":1366,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-18T14:28:18.290Z","etag":null,"topics":["colorscheme","deep-work","developer-experience","high-contrast","lua","monastic","neovim","neovim-theme"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jerryaugusto.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2026-06-17T01:21:22.000Z","updated_at":"2026-06-18T12:58:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jerryaugusto/vitrea.nvim","commit_stats":null,"previous_names":["jerryaugusto/vitrea.nvim"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jerryaugusto/vitrea.nvim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerryaugusto%2Fvitrea.nvim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerryaugusto%2Fvitrea.nvim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerryaugusto%2Fvitrea.nvim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerryaugusto%2Fvitrea.nvim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jerryaugusto","download_url":"https://codeload.github.com/jerryaugusto/vitrea.nvim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jerryaugusto%2Fvitrea.nvim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35421719,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-13T02:00:06.543Z","response_time":119,"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":["colorscheme","deep-work","developer-experience","high-contrast","lua","monastic","neovim","neovim-theme"],"created_at":"2026-07-13T12:02:33.626Z","updated_at":"2026-07-13T12:02:34.511Z","avatar_url":"https://github.com/jerryaugusto.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/vitrea-rosacea.png\" alt=\"VITREA Rosácea\" width=\"400\"/\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003eV I T R E A\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eOrdo et Silentium. The Architecture of Silence and Contemplation.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://neovim.io/\"\u003e\u003cimg src=\"https://img.shields.io/badge/Neovim-0.12.0+-blue.svg?style=for-the-badge\u0026logo=neovim\" alt=\"Neovim 0.12+\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://lua.org\"\u003e\u003cimg src=\"https://img.shields.io/badge/Compiler-LuaJIT-000080.svg?style=for-the-badge\u0026logo=lua\" alt=\"LuaJIT\"\u003e\u003c/a\u003e\n  \u003ca href=\"#-the-liturgical-hours\"\u003e\u003cimg src=\"https://img.shields.io/badge/State-Vesper-B98448.svg?style=for-the-badge\" alt=\"Vesper\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003e *\"The sensation of typing within Vitrea is that of studying under the light of a single candle in a closed scriptorium.\"*\n\nVITREA is not a mere \"colorscheme\". It is a visual containment engine—a sanctuary architected under the structural principles of High Middle Ages cathedrals and the chiaroscuro physics of Caravaggio. It is engineered specifically for backend developers (Golang, Rust) who seek deep focus through the methodology of *The Intellectual Life*.\n\nModern development environments suffer from *horror vacui* (the fear of empty space), filling every pixel with saturated neon colors, artificial borders, and plastic cybernetics. VITREA annihilates this noise. We have eradicated synthetic light in favor of physical materiality: raw linen, crushed stone, unbleached parchment, and oxidized minerals.\n\n## 🏛 The Visual Showcase\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/showcase-go.png\" width=\"80%\" alt=\"VITREA Showcase Vesper\"\u003e\n  \u003c!-- \u003cimg src=\"assets/showcase-rs.png\" width=\"80%\" alt=\"VITREA Showcase Vesper\"\u003e --\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eThe Alchemy of Vesper: Demonstrating the eradication of synthetic aesthetics in favor of tactile depth and optical charity.\u003c/em\u003e\n\u003c/p\u003e\n\n## ⚙️ Engineering Dogmas\n\nVITREA was forged to be an elite product in performance and stability, sustained by three immutable dogmas of software:\n\n1. **Zero Latency (Cache Stasis):** Unlike traditional themes that process extensive tables at every startup, VITREA features an embedded compiler (`compiler.lua`). Upon the first execution, it fuses all UI, Tree-sitter, and LSP rules into static LuaJIT Bytecode instructions. The result is a mathematically proven startup time of **\u003c 1 millisecond**.\n2. **The Doctrine of Containment:** No color outside the canonical pillars may cross the editor's gates. Standard ANSI reds and greens are strictly intercepted by the global `muzzle.lua`, ensuring integrated terminals inherit the optical matrix. Third-party UI tools (`blink.cmp`, `snacks.picker`, `mini.files`) are stripped of artificial borders and forced into seamless, borderless integrations using native `WinBlend`.\n3. **Dynamic Optical Physics:** For infinitesimal UI adjustments, `optics.lua` utilizes strict alpha interpolation against absolute light or absolute vacuum at compile-time, keeping the core hex table immaculate.\n\n## 📥 Installation\n\nVITREA demands Neovim 0.12.0+ (Nightly) to leverage the most advanced native Lua APIs. It provides absolute peace with **zero configuration required**, intelligently detecting and adapting to your ecosystem out of the box.\n\nUsing [lazy.nvim](https://github.com/folke/lazy.nvim):\n\n```lua\n{\n    \"jerryaugusto/vitrea.nvim\",\n    lazy = false,\n    priority = 1000,\n    opts = {\n        -- We grant the transmutation of liturgical hours according to the weariness of the sun.\n        liturgy = \"vesper\", -- \"matina\" | \"vesper\" | \"vigil\"\n\n        -- VITREA operates perfectly with zero configuration.\n        -- However, for the architects who demand absolute control:\n        integrations = {\n            blink_cmp = { enabled = true },\n            mini      = { enabled = true },\n            snacks    = { enabled = true },\n        }\n    },\n    config = function(_, opts)\n        require(\"vitrea\").setup(opts)\n        vim.cmd.colorscheme(\"vitrea\")\n    end,\n}\n```\n*To regenerate the LuaJIT bytecode cache after modifying options, execute `:VitreaCompile`.*\n\n---\n\n## 🧱 The Aesthetic Audit: Forging the Canon\n\nTo comprehend the *Vesper* palette is to understand our categorical refusal to accept industry standards. In our pursuit of elevating software engineering to High Culture, we subjected traditional IDE design to a brutal visual and philosophical audit.\n\nWe recognized that modern interfaces are governed by a cowardly \"muscle memory.\" We became accustomed to neon, synthetic hues, \"hacker green,\" and \"cyberpunk cyan\" simply because the cathode-ray tubes of the past conditioned us to them—plastics and lasers disguised as tools for focus. To reflect *Ordo et Silentium*, we banished the synthetic and embraced the organic. Each of our 17 canonical pillars ceased to be a light-emitting hex code; they are treated as physical pigments, crushed against stone, reacting to the penumbra.\n\n### I. The Tenebrist Foundation (The Void \u0026 Silence)\n\nCaravaggio's physics of light dictates that darkness is not the absence of color, but a protective, welcoming presence. The background of your editor is not an empty canvas; it is the air of the cloister.\n\n| Liturgical Stone | HEX Code | Ontological Function \u0026 Materiality |\n| :--- | :--- | :--- |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=161514\u0026color=161514\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Obsidian Nave** | `#161514` | **Global Background.** We rejected generic blue-grey \"night modes\" to forge the true Void. An abyssal black with microscopic earthly warmth, meticulously calculated to absorb optical fatigue and eradicate astigmatism-inducing glare. |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=1A1918\u0026color=1A1918\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Midnight Rain** | `#1A1918` | **Stealth UI.** A millimetric step of light above the Obsidian Nave to accommodate inactive terminals and status bars. This invisible mortar allows us to apply the Doctrine of Containment, separating UI from code using the physical thickness of shadows rather than drawn borders. |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=262423\u0026color=262423\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Cloister Shadow** | `#262423` | **Line Numbers.** The borders of your code should never scream for attention. This shade provides a gentle, tactile anchor that completely vanishes into your peripheral vision the exact second your fovea locks onto the syntax. |\n\n### II. Potency \u0026 Mortar (The Passive Structure)\n\nIn Thomistic thought, *Potency* is the capacity to be, not the action itself. Code foundations and base syntax must strictly retreat to prevent the infamous *horror vacui*.\n\n| Liturgical Stone | HEX Code | Ontological Function \u0026 Materiality |\n| :--- | :--- | :--- |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=3E3A38\u0026color=3E3A38\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Abbey Dust** | `#3E3A38` | **Delimiters (@punctuation).** The invisible mortar. Drastically flattening the luminance of braces, brackets, and commas was our greatest triumph against cognitive fatigue. The code breathes, sinking into the Z-axis. |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=8C8A85\u0026color=8C8A85\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Martyr's Ash** | `#8C8A85` | **Types \u0026 Interfaces (@type).** Flat, stoic mineral ash. In architectural languages (Go, Rust), types do not act; they establish laws. They sit passively behind the variables they govern. |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=5A5856\u0026color=5A5856\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Veil Silver** | `#5A5856` | **Ghost Text / Inlay Hints.** Purely speculative potency—code that does not yet exist in reality. Carefully restrained below a 4.5:1 contrast ratio, ensuring algorithmic suggestions never compete with materialized logic. |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=65737E\u0026color=65737E\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Incense Smoke** | `#65737E` | **Visual Selection (CursorLine).** We avoided translucent blues that profane the original syntax. This mid-luminance grey does not alter the hue of the code; it merely elevates it physically toward you, providing an unmistakable tactile step. |\n\n### III. The Organic Flesh (The End of Synthetic Lies)\n\nCode at rest must possess physical weight, not electrical glare. Here, we redeemed ourselves from the industry's aesthetic cowardice.\n\n| Liturgical Stone | HEX Code | Ontological Function \u0026 Materiality |\n| :--- | :--- | :--- |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=D8D2C4\u0026color=D8D2C4\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Scriptorium Parchment** | `#D8D2C4` | **Variables (@variable).** We rejected the retina-burning pure white of illuminated screens. Variables rest in a warm, desaturated, aged white, physically simulating parchment for endless hours of reading. |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=B4A894\u0026color=B4A894\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Vellum Linen** | `#B4A894` | **Parameters (@parameter).** Raw linen texture. A subtle, organic drop in luminance that instinctively whispers to the brain that the data is a foreign body, completely eliminating the need for chromatic alarms. |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=5E7B74\u0026color=5E7B74\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Patina Verdigris** | `#5E7B74` | **Booleans \u0026 Constants.** The death of cyberpunk cyan. To represent absolute, immutable truth, we employed Verdigris—the classic, lethargic oxidation of copper. Cold enough to indicate immutability, yet firmly carved in mineral stone. |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=7B8770\u0026color=7B8770\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Malachite Dust** | `#7B8770` | **Strings (@string).** The explicit purge of \"hacker green\". Strings are literal human literature embedded in the machine. Crushed malachite and dehydrated sage honor the 555nm physiological optical peak, but do so with mature, earthy weight. |\n\n### IV. Act \u0026 Action (The Foveal Hierarchy)\n\nWhen the system moves, foveal vision must be hijacked instantly, but with elegant, liturgical grace.\n\n| Liturgical Stone | HEX Code | Ontological Function \u0026 Materiality |\n| :--- | :--- | :--- |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=D3A75B\u0026color=D3A75B\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Tabernacle Gold** | `#D3A75B` | **Properties \u0026 State Mutation.** The highest chromatic luminance of the palette. State mutation is the source of all systemic complexity; the Gold tears through the chiaroscuro, unapologetically forcing your optical macula to track the flow of data. |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=4B6C82\u0026color=4B6C82\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Woad Indigo** | `#4B6C82` | **Functions \u0026 Methods (@function).** The engine of action. A dense, retreating oxidized indigo. It explicitly signals where action occurs but gracefully surrenders the crown of foveal contrast to the Gold. Deeply noble, yet recessive. |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=A5707B\u0026color=A5707B\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Sacrament Rose** | `#A5707B` | **Control Flow (if, return).** Faded ecclesiastical magenta. Control flow must never trigger a vibrant alarm. This rose establishes a visual cadence—a silent metronome guiding your eye through logical branches with rhythm, not anxiety. |\n\n### V. Friction \u0026 Metasyntax (The Weight of Danger)\n\nComplex systems bleed under pressure. The palette must signal structural risk by communicating gravity and heat.\n\n| Liturgical Stone | HEX Code | Ontological Function \u0026 Materiality |\n| :--- | :--- | :--- |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=A86F50\u0026color=A86F50\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Censer Terracotta** | `#A86F50` | **Macros \u0026 Metasyntax (@operator).** Burned earth. Reserved for compiler directives, raw pointers, and global state. The code bleeds with an ancient, terrestrial heat, warning the architect of deep structural manipulation. |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=B98448\u0026color=B98448\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Vesper Amber** | `#B98448` | **Diagnostic Warnings.** Autumnal amber. Indicates architectural friction or code smells without ever invoking the sympathetic nervous system's fight-or-flight response. |\n| \u003cimg src=\"https://ui-avatars.com/api/?background=A94A42\u0026color=A94A42\u0026rounded=true\" width=\"28\" height=\"28\" align=\"center\"\u003e **Relic Vermilion** | `#A94A42` | **Diagnostic Errors.** Oxidized blood dried on a relic. We repudiate the cardinal red of generic IDEs that shatters vision. The gravity of a broken application demands absolute, solemn respect and total silence, not strident neon. |\n\n---\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eFor architectural contributions or to report a breach in containment, please consult the \u003ca href=\"CONTRIBUTING.md\"\u003eScribe's Guidelines\u003c/a\u003e.\u003c/em\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjerryaugusto%2Fvitrea.nvim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjerryaugusto%2Fvitrea.nvim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjerryaugusto%2Fvitrea.nvim/lists"}