trent-maetzold/hearthworks
1
0
Fork 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions
No description
405 commits 3 branches 0 tags 788 KiB
  • Nix 67.1%
  • Lua 24.7%
  • Shell 5.8%
  • Just 2.4%
Find a file
Exact
Trent Maetzold 1a9640862b Merge pull request 'hearthworks: merge homelab stacks + move flake to nix/ + packages scaffold' (#2) from monorepo into main 
Reviewed-on: #2
2026-08-14 07:25:04 -05:00
docs/superpowers docs: update design spec with client package and factory isolation 2026-06-30 08:48:18 -05:00
nix refactor: move flake to root of repo 2026-08-14 07:23:33 -05:00
packages feat: scaffold packages sub-monorepo (tools, apps) 2026-08-13 20:09:31 -05:00
plans feat(authentik): deduplicate env vars with yaml anchor, add protonmail smtp 2026-04-25 09:39:55 -05:00
stacks fix: change litellm model config 2026-07-19 00:00:40 -05:00
.gitignore merge: import homelab history (agents) into hearthworks 2026-08-13 20:09:13 -05:00
.prettierrc.yaml feat: add authelia stack and wire traefik dashboard through file provider 2026-04-25 14:55:15 -05:00
AGENTS.md docs: restructure AGENTS.md and README for hearthworks monorepo 2026-08-13 20:09:49 -05:00
flake.lock refactor: move flake to root of repo 2026-08-14 07:23:33 -05:00
flake.nix refactor: move flake to root of repo 2026-08-14 07:23:33 -05:00
justfile fix: use POSTGRES_PASSWORD in contextforge consumer stack; add gen-password recipe 2026-04-05 22:45:29 -05:00
README.md docs: restructure AGENTS.md and README for hearthworks monorepo 2026-08-13 20:09:49 -05:00
TODO.md feat: initial homelab repo 2026-02-13 14:16:07 -06:00

README.md

Hearthworks

One monorepo for the home server: NixOS/Home-Manager flake + Docker Compose homelab stacks.

Repository layout

nix/        — NixOS & Home Manager flake (flake.nix, hosts/, home/, modules/, pkgs/, roles/)
stacks/     — Docker Compose stacks (Unraid homelab)
packages/   — sub-monorepo: tools/ + apps/ (agent tools, MCP servers, apis, websites)
plans/      — design/plan docs
docs/       — superpowers plans/specs

Usage

Flake commands run from nix/:

cd nix
nix flake check
nix build .#homeConfigurations.tm.activationPackage

Switch Home Manager:

home-manager switch --flake ~/dotfiles/nix

Sync the homelab stacks to Unraid:

just sync-stacks

See AGENTS.md for the full conventions (stacks layout, compose style, naming, env vars, volumes, networks, labels).