Initial release

Author: Ferouk

.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  lint-and-smoke:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Stylua
+        uses: JohnnyMorganz/stylua-action@v3
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          version: latest
+          args: --check .
+
+      - name: Install Neovim
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y neovim
+
+      - name: Smoke test
+        run: ./scripts/smoke.sh

.gitignore

@@ -0,0 +1,19 @@
+# Upstream checkout used for palette generation (not tracked)
+bearded-theme/
+
+# Node / editor
+node_modules/
+.DS_Store
+
+# Lua language server metadata
+.luarc.json
+
+# Neovim artifacts
+.local/
+.cache/
+
+# Generated helptags
+doc/tags
+
+# nvim log
+.nvimlog

CONTRIBUTING.md

@@ -0,0 +1,47 @@
+# 🤝 Contributing to bearded-nvim
+
+Thanks for your interest! This project mirrors the upstream VS Code Bearded Theme palettes and ships a Neovim colorscheme with integrations.
+
+## Workflow
+
+- 🧭 Clone the upstream VS Code theme to pull palettes: <https://github.com/BeardedBear/bearded-theme>
+- 🌉 Point `BEARDED_THEME_PATH` to that clone when regenerating.
+- 🔄 Regenerate palettes/stubs when upstream changes:
+
+  ```bash
+  BEARDED_THEME_PATH=/path/to/bearded-theme ./scripts/regen.sh
+  ```
+
+- 🧹 Format Lua:
+
+  ```bash
+  stylua .
+  ```
+
+- 🧪 Smoke test (headless load):
+
+  ```bash
+  ./scripts/smoke.sh
+  ```
+
+## PR checklist
+
+- [ ] 🔄 Palettes regenerated if upstream changed
+- [ ] 🧹 Stylua clean
+- [ ] 🧪 Smoke test passes
+- [ ] 📝 Highlight changes documented in the PR
+
+## Reporting issues
+
+- 🐛 Include Neovim version (`nvim --version`), flavor slug, and screenshots if it’s a visual issue.
+
+## Requirements
+
+- 🐍 Python 3 (for palette export/generation)
+- 🛰️ Neovim in PATH (for `scripts/smoke.sh`)
+- 🧹 Stylua (formatter)
+- 🌉 Access to the upstream repo (cloned locally) for palette regeneration
+
+## License
+
+- 📝 GPL-3.0-only (see LICENSE)