harivansh-afk/betterNAS
1
1
Fork 0
mirror of https://github.com/harivansh-afk/betterNAS.git synced 2026-04-15 03:00:44 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
filesystem admin over HTTP https://www.betternas.com
28 commits 15 branches 1 tag 1.1 MiB
Find a file
Hari e2f03f47af
pnpm, verify, cleanup (#6)
2026-03-31 23:59:52 -04:00
apps pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
docs pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
infra/docker pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
packages pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
scripts pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
.editorconfig pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
.gitignore init (#5) 2026-03-31 23:50:51 -04:00
.prettierignore pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
go.work init (#5) 2026-03-31 23:50:51 -04:00
go.work.sum init (#5) 2026-03-31 23:50:51 -04:00
package.json pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
pnpm-lock.yaml pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
pnpm-workspace.yaml pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
README.md pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
skeleton.md pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
TODO.md pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
tsconfig.base.json pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00
turbo.json pnpm, verify, cleanup (#6) 2026-03-31 23:59:52 -04:00

README.md

betterNAS

image

Start here

The canonical repo contract lives in docs/architecture.md.

Read these in order:

  1. docs/architecture.md
  2. docs/01-nas-node.md
  3. docs/02-control-plane.md
  4. docs/03-local-device.md
  5. docs/04-cloud-web-layer.md
  6. docs/05-build-plan.md
  7. docs/references.md

Current direction

  • betterNAS is WebDAV-first for mount mode.
  • the control plane is the system of record.
  • the NAS node serves bytes directly whenever possible.
  • Nextcloud is an optional cloud/web adapter, not the product center.

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