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

Runtime loop

Bootstrap clone-local runtime settings with:

pnpm agent:bootstrap

If .env.agent is missing, bootstrap writes clone-local defaults for this checkout.

Bring the stack up, verify it, and tear it down with:

pnpm stack:up
pnpm stack:verify
pnpm stack:down --volumes

Agent loop

Run the full static and integration loop with:

pnpm agent:verify

Create or refresh the sibling agent clones with:

pnpm clones:setup