chore: scaffold repo skeleton

Empty placeholder commit anchoring the repo. Substantive scaffolding
(flake.nix, modules/, settings.nix) lands in follow-ups iterated under
the sandboxed-claude policy.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Padreug 2026-05-24 19:21:12 +02:00
commit 677b8c7c27
2 changed files with 59 additions and 0 deletions

44
README.md Normal file
View file

@ -0,0 +1,44 @@
# lnbits-sensei
> **Status:** scaffold in progress. Not yet usable.
Opinionated, bare-skeleton scaffold for running an LNbits stack
— inspired by the [omnixy](https://github.com/TheArctesian/omnixy)
NixOS module pattern but stripped of any personal identity so the
template is consumable as-is.
The goal: clone, fill in your identity + remote topology (upstream
only / github fork / extra private remote on gitea, forgejo,
codeberg, …), and get a working LNbits dev environment with either:
- **FakeWallet** — no docker, no chains, nothing to start. Fast
iteration on extensions and frontend work.
- **Full regtest** — multi-node LND + CLN + Eclair stack with
bitcoind, electrs, boltz, etc. For channel/payment integration
testing.
## Planned shape
- `flake.nix` — pins `lnbits/lnbits` upstream + dev tooling.
- `settings.nix` — single source of truth (user, email, host, remote
topology). User fills in.
- `modules/lnbits/` — opinionated LNbits NixOS module.
- `modules/dev-env/` — worktree mgmt, navigation helpers, regtest
spin-up, fakewallet default, upstream-PR helper. Generalized off
any private-host assumptions.
- `modules/git/remotes.nix` — abstract remote topology (`upstream`,
`fork`, optional `extras` list).
## Development
This repo is iterated on under the sandboxed-claude policy from
[omnixy](https://github.com/TheArctesian/omnixy)'s
`scripts/sandbox-claude.sh` — a per-launch `.claude/settings.json`
that allows nix/git/inspection and hard-denies sudo, push/remote,
container engines, etc. Substantive scaffolding work happens in that
sandbox; promotion (`git push`) is done from the main shell after
review.
## License
TBD — leaning MIT to match omnixy.