Feat/modular public setup

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,55 @@
+name: Bug report
+description: Report a reproducible problem with a Macarchy component.
+title: "bug: "
+labels:
+  - bug
+body:
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      options:
+        - Installer
+        - Window manager
+        - SketchyBar
+        - Terminal
+        - Shell
+        - Neovim
+        - Utilities
+        - Themes
+        - Raycast
+    validations:
+      required: true
+
+  - type: input
+    id: macos
+    attributes:
+      label: macOS version and Mac model
+      placeholder: macOS 26.5, MacBook Pro with M3 Pro
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: What happened?
+      description: Include the command you ran, what you expected and what happened instead.
+    validations:
+      required: true
+
+  - type: textarea
+    id: output
+    attributes:
+      label: Relevant output
+      description: Remove usernames, home-directory paths, tokens and other private data first.
+      render: shell
+
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Checks
+      options:
+        - label: I used `./install --dry-run` where applicable.
+          required: true
+        - label: I removed personal information from the report.
+          required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,21 @@
+name: Feature request
+description: Suggest a focused improvement or a new optional component.
+title: "feat: "
+labels:
+  - enhancement
+body:
+  - type: textarea
+    id: need
+    attributes:
+      label: What would this help you do?
+      description: Describe the use case before the proposed implementation.
+    validations:
+      required: true
+
+  - type: textarea
+    id: scope
+    attributes:
+      label: Suggested scope
+      description: Explain whether this belongs in a default, an optional component or an example.
+    validations:
+      required: true

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+## What changed
+
+Describe the behaviour and the component it affects.
+
+## Checks
+
+- [ ] `./scripts/check.sh` passes
+- [ ] No personal paths, accounts or app rules were added to defaults
+- [ ] New dependencies and assets include their source and licence
+- [ ] User-facing behaviour is documented

.github/dependabot.yml

@@ -0,0 +1,13 @@
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: /raycast-theme
+    schedule:
+      interval: weekly
+    open-pull-requests-limit: 5
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: monthly
+    open-pull-requests-limit: 3

.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    name: Repository checks (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 15
+
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu-latest
+          - macos-15
+
+    steps:
+      - name: Check out the repository
+        uses: actions/checkout@v6
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: npm
+          cache-dependency-path: raycast-theme/package-lock.json
+
+      - name: Install validation tools
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install --yes --no-install-recommends jq zsh
+
+      - name: Ensure jq is available
+        if: runner.os == 'macOS'
+        run: command -v jq >/dev/null || brew install jq
+
+      - name: Run repository checks
+        run: ./scripts/check.sh

.gitignore

@@ -6,12 +6,14 @@
 *.bak
 
 # Runtime-generated files under installed dotfiles.
-btop/themes/active-theme.theme
+btop/themes/macarchy.theme
 raycast-*/node_modules/
 raycast-*/.raycast/
 raycast-*/dist/
 themes/.backgrounds.json
+themes/.current
 sketchybar/theme.sh
 sketchybar/.state/
+macarchy/generated/
 yabai/.sketchybar_hidden
 yabai/float_state.json

CONTRIBUTING.md

@@ -0,0 +1,17 @@
+# Contributing
+
+Thanks for helping improve Macarchy.
+
+Keep changes focused on portable macOS configuration. Personal app rules, account switchers and machine-specific paths should be examples or local overrides rather than defaults.
+
+Before opening a pull request:
+
+```sh
+./scripts/check.sh
+```
+
+The check covers shell syntax, installer behaviour, theme safety, personal-path scanning and the Raycast build. Do not run a real install or apply a theme as part of a test.
+
+For a new component, include a dry-run path, a safe uninstall path and a short guide. For a new theme, include its source, licence and wallpaper credits in `THIRD_PARTY_NOTICES.md`.
+
+Use clear commit prefixes such as `feat:`, `fix:`, `refactor:` and `docs:`. Write in plain language and explain behaviour that is not obvious from the code.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Macarchy contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.