{"id":48706785,"url":"https://github.com/getlumos/nvim-lumos","last_synced_at":"2026-04-11T11:35:42.484Z","repository":{"id":325764301,"uuid":"1102299863","full_name":"getlumos/nvim-lumos","owner":"getlumos","description":"Neovim plugin for LUMOS with LSP and Tree-sitter support","archived":false,"fork":false,"pushed_at":"2026-02-06T08:25:35.000Z","size":28,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-06T16:32:42.224Z","etag":null,"topics":["anchor","blockchain","borsh","code-generation","developer-tools","language-server-protocol","lsp","lua","lumos","neovim","neovim-plugin","nvim-lspconfig","nvim-treesitter","rust","schema-language","solana","syntax-highlighting","treesitter","type-safety","typescript"],"latest_commit_sha":null,"homepage":null,"language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/getlumos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE-APACHE","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-11-23T07:36:37.000Z","updated_at":"2026-02-06T08:25:40.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/getlumos/nvim-lumos","commit_stats":null,"previous_names":["getlumos/nvim-lumos"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/getlumos/nvim-lumos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getlumos%2Fnvim-lumos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getlumos%2Fnvim-lumos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getlumos%2Fnvim-lumos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getlumos%2Fnvim-lumos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/getlumos","download_url":"https://codeload.github.com/getlumos/nvim-lumos/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/getlumos%2Fnvim-lumos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31679480,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-11T08:18:19.405Z","status":"ssl_error","status_checked_at":"2026-04-11T08:17:08.892Z","response_time":54,"last_error":"SSL_read: 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":["anchor","blockchain","borsh","code-generation","developer-tools","language-server-protocol","lsp","lua","lumos","neovim","neovim-plugin","nvim-lspconfig","nvim-treesitter","rust","schema-language","solana","syntax-highlighting","treesitter","type-safety","typescript"],"created_at":"2026-04-11T11:35:41.876Z","updated_at":"2026-04-11T11:35:42.479Z","avatar_url":"https://github.com/getlumos.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# nvim-lumos\n\nNeovim plugin for LUMOS schema language with Tree-sitter syntax highlighting and LSP support.\n\n## Features\n\n- **Syntax Highlighting**: Full Tree-sitter grammar for `.lumos` files\n- **LSP Integration**: Auto-completion, diagnostics, hover, and more via `lumos-lsp`\n- **Smart Keybindings**: Pre-configured keymaps for common LSP operations\n- **Formatting**: Format on save support\n\n## Prerequisites\n\n1. **Neovim 0.9+** (for Tree-sitter and LSP support)\n2. **lumos-lsp**: LUMOS Language Server\n   ```bash\n   cargo install lumos-lsp\n   ```\n3. **nvim-treesitter**: Tree-sitter integration for Neovim\n4. **nvim-lspconfig**: LSP configuration framework\n\n## Installation\n\n### Using lazy.nvim\n\n```lua\n{\n  \"getlumos/nvim-lumos\",\n  dependencies = {\n    \"nvim-treesitter/nvim-treesitter\",\n    \"neovim/nvim-lspconfig\",\n  },\n  config = function()\n    require(\"lumos\").setup()\n  end,\n}\n```\n\n### Using packer.nvim\n\n```lua\nuse {\n  \"getlumos/nvim-lumos\",\n  requires = {\n    \"nvim-treesitter/nvim-treesitter\",\n    \"neovim/nvim-lspconfig\",\n  },\n  config = function()\n    require(\"lumos\").setup()\n  end,\n}\n```\n\n### Manual Installation\n\n1. Clone this repository:\n   ```bash\n   git clone https://github.com/getlumos/nvim-lumos ~/.local/share/nvim/site/pack/lumos/start/nvim-lumos\n   ```\n\n2. Install Tree-sitter parser:\n   ```bash\n   cd ~/.local/share/nvim/site/pack/lumos/start/nvim-lumos\n   git clone https://github.com/getlumos/tree-sitter-lumos\n   ```\n\n3. Add to your `init.lua`:\n   ```lua\n   require(\"lumos\").setup()\n   ```\n\n## Configuration\n\n### Basic Setup\n\n```lua\nrequire(\"lumos\").setup()\n```\n\n### Custom Configuration\n\n```lua\nrequire(\"lumos\").setup({\n  -- Custom options (currently none, reserved for future)\n})\n```\n\n### Tree-sitter Setup (Optional)\n\nIf you want to manually configure Tree-sitter:\n\n```lua\nrequire(\"nvim-treesitter.configs\").setup({\n  ensure_installed = { \"lumos\" },\n  highlight = {\n    enable = true,\n  },\n})\n```\n\n### LSP Custom Configuration\n\nTo customize LSP behavior:\n\n```lua\nlocal lspconfig = require(\"lspconfig\")\n\nlspconfig.lumos.setup({\n  on_attach = function(client, bufnr)\n    -- Your custom on_attach logic\n    vim.keymap.set(\"n\", \"gd\", vim.lsp.buf.definition, { buffer = bufnr })\n    vim.keymap.set(\"n\", \"K\", vim.lsp.buf.hover, { buffer = bufnr })\n  end,\n  capabilities = require(\"cmp_nvim_lsp\").default_capabilities(),\n})\n```\n\n## Default Keybindings\n\nThese keybindings are automatically set up for `.lumos` files:\n\n| Key | Mode | Action |\n|-----|------|--------|\n| `gd` | Normal | Go to definition |\n| `K` | Normal | Show hover documentation |\n| `\u003cleader\u003ern` | Normal | Rename symbol |\n| `\u003cleader\u003eca` | Normal | Code actions |\n| `gr` | Normal | Find references |\n| `\u003cleader\u003ef` | Normal | Format document |\n\n## File Structure\n\n```\nnvim-lumos/\n├── ftdetect/\n│   └── lumos.lua          # File type detection for .lumos files\n├── lua/\n│   └── lumos/\n│       ├── init.lua       # Main plugin entry point\n│       └── lsp.lua        # LSP configuration\n├── queries/\n│   └── lumos/\n│       └── highlights.scm # Syntax highlighting queries\n├── LICENSE-MIT\n├── LICENSE-APACHE\n└── README.md\n```\n\n## Supported Syntax\n\nThe plugin provides syntax highlighting and LSP support for:\n\n- **Structs**: `struct Player { ... }`\n- **Enums**: `enum GameState { ... }`\n- **Attributes**: `#[solana]`, `#[account]`, `#[deprecated]`\n- **Types**:\n  - Primitives: `u8`, `u16`, `u32`, `u64`, `u128`, `i8`, `i16`, `i32`, `i64`, `i128`, `bool`, `String`\n  - Solana: `PublicKey`, `Signature`\n  - Collections: `Vec\u003cT\u003e`, `Option\u003cT\u003e`, `[T]`\n- **Comments**: `//` line comments, `/* */` block comments\n\n## Example\n\n```rust\n#[solana]\n#[account]\nstruct PlayerAccount {\n    wallet: PublicKey,\n    level: u16,\n    experience: u64,\n    inventory: Vec\u003cItem\u003e,\n}\n\n#[solana]\nenum GameState {\n    Active,\n    Paused { reason: String },\n    Finished(u64),\n}\n```\n\n## Troubleshooting\n\n### LSP not starting\n\n1. Verify `lumos-lsp` is installed:\n   ```bash\n   which lumos-lsp\n   ```\n\n2. Check LSP logs:\n   ```vim\n   :LspLog\n   ```\n\n3. Restart LSP:\n   ```vim\n   :LspRestart\n   ```\n\n### Syntax highlighting not working\n\n1. Ensure nvim-treesitter is installed\n2. Check Tree-sitter parser status:\n   ```vim\n   :TSInstallInfo lumos\n   ```\n\n3. Force reinstall parser:\n   ```vim\n   :TSInstall lumos\n   ```\n\n## Related Projects\n\n- [lumos](https://github.com/getlumos/lumos) - Core LUMOS compiler and CLI\n- [tree-sitter-lumos](https://github.com/getlumos/tree-sitter-lumos) - Tree-sitter grammar for LUMOS\n- [vscode-lumos](https://github.com/getlumos/vscode-lumos) - VSCode extension for LUMOS\n- [intellij-lumos](https://github.com/getlumos/intellij-lumos) - IntelliJ IDEA plugin for LUMOS\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n## License\n\nDual-licensed under:\n- MIT License ([LICENSE-MIT](LICENSE-MIT))\n- Apache License 2.0 ([LICENSE-APACHE](LICENSE-APACHE))\n\n## Support\n\n- GitHub Issues: https://github.com/getlumos/nvim-lumos/issues\n- Documentation: https://lumos-lang.org\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetlumos%2Fnvim-lumos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgetlumos%2Fnvim-lumos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgetlumos%2Fnvim-lumos/lists"}