betterNAS/README.md

betterNAS

• control-plane owns policy and identity (decides)
• node-agent owns file serving (serves)
• web owns UX (consumer facing)
• nextcloud-app is optional adapter only for cloud storage in s3 n shit

Monorepo

• apps/web: Next.js control-plane UI
• apps/control-plane: Go control-plane service
• apps/node-agent: Go NAS runtime / WebDAV node
• apps/nextcloud-app: optional Nextcloud adapter
• packages/contracts: canonical shared contracts
• packages/ui: shared React UI
• infra/docker: local Docker runtime

The root planning and delegation guide lives in skeleton.md.

Verify

Run the repo acceptance loop with:

pnpm verify

Agent loop

Bootstrap a clone-local environment with:

pnpm agent:bootstrap

Run the full static and integration loop with:

pnpm agent:verify

Create or refresh the sibling agent clones with:

pnpm clones:setup