init

apps/control-plane/Dockerfile

@@ -0,0 +1,15 @@
+FROM golang:1.26-alpine AS build
+
+WORKDIR /src
+COPY apps/control-plane ./apps/control-plane
+
+WORKDIR /src/apps/control-plane
+RUN CGO_ENABLED=0 GOOS=linux go build -o /out/control-plane ./cmd/control-plane
+
+FROM alpine:3.21
+
+WORKDIR /app
+COPY --from=build /out/control-plane /usr/local/bin/control-plane
+
+EXPOSE 3000
+CMD ["control-plane"]

apps/control-plane/README.md

@@ -0,0 +1,15 @@
+# betterNAS Control Plane
+
+Go service that owns the product control plane.
+
+It is intentionally small for now:
+
+- `GET /health`
+- `GET /version`
+- `POST /api/v1/nodes/register`
+- `GET /api/v1/exports`
+- `POST /api/v1/mount-profiles/issue`
+- `POST /api/v1/cloud-profiles/issue`
+
+The request and response shapes must follow the contracts in
+[`packages/contracts`](/home/rathi/Documents/GitHub/betterNAS/packages/contracts).

apps/control-plane/cmd/control-plane/main.go

@@ -0,0 +1,103 @@
+package main
+
+import (
+	"encoding/json"
+	"log"
+	"net/http"
+	"os"
+	"time"
+)
+
+type jsonObject map[string]any
+
+func main() {
+	port := env("PORT", "8081")
+	startedAt := time.Now()
+
+	mux := http.NewServeMux()
+	mux.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
+		writeJSON(w, http.StatusOK, jsonObject{
+			"service":       "control-plane",
+			"status":        "ok",
+			"timestamp":     time.Now().UTC().Format(time.RFC3339),
+			"uptimeSeconds": int(time.Since(startedAt).Seconds()),
+			"nextcloud": jsonObject{
+				"configured": false,
+				"baseUrl":    env("NEXTCLOUD_BASE_URL", ""),
+				"provider":   "nextcloud",
+			},
+		})
+	})
+	mux.HandleFunc("/version", func(w http.ResponseWriter, r *http.Request) {
+		writeJSON(w, http.StatusOK, jsonObject{
+			"service":    "control-plane",
+			"version":    env("BETTERNAS_VERSION", "0.1.0-dev"),
+			"apiVersion": "v1",
+		})
+	})
+	mux.HandleFunc("/api/v1/exports", func(w http.ResponseWriter, r *http.Request) {
+		writeJSON(w, http.StatusOK, []jsonObject{})
+	})
+	mux.HandleFunc("/api/v1/mount-profiles/issue", func(w http.ResponseWriter, r *http.Request) {
+		writeJSON(w, http.StatusOK, jsonObject{
+			"id":             "dev-profile",
+			"exportId":       "dev-export",
+			"protocol":       "webdav",
+			"displayName":    "Example export",
+			"mountUrl":       env("BETTERNAS_EXAMPLE_MOUNT_URL", "http://localhost:8090/dav"),
+			"readonly":       false,
+			"credentialMode": "session-token",
+		})
+	})
+	mux.HandleFunc("/api/v1/cloud-profiles/issue", func(w http.ResponseWriter, r *http.Request) {
+		writeJSON(w, http.StatusOK, jsonObject{
+			"id":       "dev-cloud",
+			"exportId": "dev-export",
+			"provider": "nextcloud",
+			"baseUrl":  env("NEXTCLOUD_BASE_URL", "http://localhost:8080"),
+			"path":     "/apps/files/files",
+		})
+	})
+	mux.HandleFunc("/api/v1/nodes/register", func(w http.ResponseWriter, r *http.Request) {
+		writeJSON(w, http.StatusOK, jsonObject{
+			"id":           "dev-node",
+			"machineId":    "dev-machine",
+			"displayName":  "Development NAS",
+			"agentVersion": "0.1.0-dev",
+			"status":       "online",
+			"lastSeenAt":   time.Now().UTC().Format(time.RFC3339),
+			"directAddress": env("BETTERNAS_NODE_DIRECT_ADDRESS", "http://localhost:8090"),
+			"relayAddress":  nil,
+		})
+	})
+	mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
+		http.NotFound(w, r)
+	})
+
+	server := &http.Server{
+		Addr:              ":" + port,
+		Handler:           mux,
+		ReadHeaderTimeout: 5 * time.Second,
+	}
+
+	log.Printf("betterNAS control plane listening on :%s", port)
+	log.Fatal(server.ListenAndServe())
+}
+
+func env(key, fallback string) string {
+	value, ok := os.LookupEnv(key)
+	if !ok || value == "" {
+		return fallback
+	}
+
+	return value
+}
+
+func writeJSON(w http.ResponseWriter, statusCode int, payload any) {
+	w.Header().Set("Content-Type", "application/json; charset=utf-8")
+	w.WriteHeader(statusCode)
+
+	if err := json.NewEncoder(w).Encode(payload); err != nil {
+		http.Error(w, err.Error(), http.StatusInternalServerError)
+	}
+}

apps/control-plane/go.mod

@@ -0,0 +1,3 @@
+module github.com/rathi/betternas/apps/control-plane
+
+go 1.26.0

apps/control-plane/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@betternas/control-plane",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "CGO_ENABLED=0 go run ./cmd/control-plane",
+    "build": "mkdir -p dist && CGO_ENABLED=0 go build -o dist/control-plane ./cmd/control-plane",
+    "lint": "CGO_ENABLED=0 go vet ./...",
+    "check-types": "CGO_ENABLED=0 go test ./...",
+    "test": "CGO_ENABLED=0 go test ./..."
+  }
+}

apps/node-agent/README.md

@@ -0,0 +1,10 @@
+# betterNAS Node Agent
+
+Go service that runs on the NAS machine.
+
+For the scaffold it does two things:
+
+- serves `GET /health`
+- serves a WebDAV export at `/dav/`
+
+This is the first real storage-facing surface in the monorepo.

apps/node-agent/cmd/node-agent/main.go

@@ -0,0 +1,46 @@
+package main
+
+import (
+	"log"
+	"net/http"
+	"os"
+	"time"
+
+	"golang.org/x/net/webdav"
+)
+
+func main() {
+	port := env("PORT", "8090")
+	exportPath := env("BETTERNAS_EXPORT_PATH", ".")
+
+	mux := http.NewServeMux()
+	mux.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
+		w.Header().Set("Content-Type", "text/plain; charset=utf-8")
+		_, _ = w.Write([]byte("ok\n"))
+	})
+
+	dav := &webdav.Handler{
+		Prefix:     "/dav",
+		FileSystem: webdav.Dir(exportPath),
+		LockSystem: webdav.NewMemLS(),
+	}
+	mux.Handle("/dav/", dav)
+
+	server := &http.Server{
+		Addr:              ":" + port,
+		Handler:           mux,
+		ReadHeaderTimeout: 5 * time.Second,
+	}
+
+	log.Printf("betterNAS node agent serving %s on :%s", exportPath, port)
+	log.Fatal(server.ListenAndServe())
+}
+
+func env(key, fallback string) string {
+	value, ok := os.LookupEnv(key)
+	if !ok || value == "" {
+		return fallback
+	}
+
+	return value
+}

apps/node-agent/go.mod

@@ -0,0 +1,5 @@
+module github.com/rathi/betternas/apps/node-agent
+
+go 1.26.0
+
+require golang.org/x/net v0.46.0

apps/node-agent/go.sum

@@ -0,0 +1,2 @@
+golang.org/x/net v0.46.0 h1:giFlY12I07fugqwPuWJi68oOnpfqFnJIJzaIIm2JVV4=
+golang.org/x/net v0.46.0/go.mod h1:Q9BGdFy1y4nkUwiLvT5qtyhAnEHgnQ/zd8PfU6nc210=

apps/node-agent/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@betternas/node-agent",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "CGO_ENABLED=0 go run ./cmd/node-agent",
+    "build": "mkdir -p dist && CGO_ENABLED=0 go build -o dist/node-agent ./cmd/node-agent",
+    "lint": "CGO_ENABLED=0 go vet ./...",
+    "check-types": "CGO_ENABLED=0 go test ./...",
+    "test": "CGO_ENABLED=0 go test ./..."
+  }
+}

apps/web/.gitignore

@@ -0,0 +1,36 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+.yarn/install-state.gz
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# env files (can opt-in for commiting if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

apps/web/README.md

@@ -0,0 +1,13 @@
+# betterNAS Web
+
+Next.js control-plane UI for betterNAS.
+
+Use this app for:
+
+- admin and operator workflows
+- node and export visibility
+- issuing mount profiles
+- later cloud-mode management
+
+Do not move the product system of record into this app. It should stay a UI and
+thin BFF layer over the Go control plane.

apps/web/app/globals.css

@@ -0,0 +1,50 @@
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+html,
+body {
+  max-width: 100vw;
+  overflow-x: hidden;
+}
+
+body {
+  color: var(--foreground);
+  background: var(--background);
+}
+
+* {
+  box-sizing: border-box;
+  padding: 0;
+  margin: 0;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+.imgDark {
+  display: none;
+}
+
+@media (prefers-color-scheme: dark) {
+  html {
+    color-scheme: dark;
+  }
+
+  .imgLight {
+    display: none;
+  }
+  .imgDark {
+    display: unset;
+  }
+}

apps/web/app/layout.tsx

@@ -0,0 +1,31 @@
+import type { Metadata } from "next";
+import localFont from "next/font/local";
+import "./globals.css";
+
+const geistSans = localFont({
+  src: "./fonts/GeistVF.woff",
+  variable: "--font-geist-sans",
+});
+const geistMono = localFont({
+  src: "./fonts/GeistMonoVF.woff",
+  variable: "--font-geist-mono",
+});
+
+export const metadata: Metadata = {
+  title: "betterNAS",
+  description: "Contract-first monorepo for NAS mounts and optional cloud access",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body className={`${geistSans.variable} ${geistMono.variable}`}>
+        {children}
+      </body>
+    </html>
+  );
+}

apps/web/app/page.module.css

@@ -0,0 +1,77 @@
+.page {
+  min-height: 100svh;
+  padding: 48px 24px 80px;
+  background:
+    radial-gradient(circle at top left, rgba(91, 186, 166, 0.18), transparent 28%),
+    linear-gradient(180deg, #f5fbfa 0%, #edf5f3 100%);
+  color: #10212d;
+}
+
+.hero {
+  max-width: 860px;
+  margin: 0 auto 32px;
+  padding: 32px;
+  border-radius: 28px;
+  background: linear-gradient(135deg, #123043 0%, #1d5466 100%);
+  color: #f7fbfc;
+  box-shadow: 0 24px 80px rgba(16, 33, 45, 0.14);
+}
+
+.eyebrow {
+  margin: 0 0 12px;
+  font-size: 12px;
+  letter-spacing: 0.12em;
+  text-transform: uppercase;
+  opacity: 0.78;
+}
+
+.title {
+  margin: 0 0 12px;
+  font-size: clamp(2.25rem, 5vw, 4rem);
+  line-height: 0.98;
+}
+
+.copy {
+  margin: 0;
+  max-width: 64ch;
+  font-size: 1rem;
+  line-height: 1.7;
+}
+
+.grid {
+  max-width: 860px;
+  margin: 0 auto;
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
+  gap: 18px;
+}
+
+.card {
+  display: block;
+  padding: 22px;
+  border-radius: 20px;
+  background: rgba(255, 255, 255, 0.88);
+  border: 1px solid rgba(18, 48, 67, 0.08);
+  box-shadow: 0 12px 30px rgba(18, 48, 67, 0.08);
+  color: inherit;
+  text-decoration: none;
+}
+
+.card h2 {
+  margin: 0 0 10px;
+}
+
+.card p {
+  margin: 0;
+  line-height: 1.6;
+}
+
+@media (max-width: 640px) {
+  .page {
+    padding-inline: 16px;
+  }
+
+  .hero {
+    padding: 24px;
+  }
+}

apps/web/app/page.tsx

@@ -0,0 +1,45 @@
+import { Card } from "@betternas/ui/card";
+import styles from "./page.module.css";
+
+const lanes = [
+  {
+    title: "NAS node",
+    body: "Runs on the storage machine. Exposes WebDAV, reports exports, and stays close to the bytes.",
+  },
+  {
+    title: "Control plane",
+    body: "Owns users, devices, nodes, grants, mount profiles, and cloud profiles.",
+  },
+  {
+    title: "Local device",
+    body: "Consumes mount profiles and uses Finder WebDAV flows before we ship a helper app.",
+  },
+  {
+    title: "Cloud layer",
+    body: "Keeps Nextcloud optional and thin for browser, mobile, and sharing flows.",
+  },
+];
+
+export default function Home() {
+  return (
+    <main className={styles.page}>
+      <section className={styles.hero}>
+        <p className={styles.eyebrow}>betterNAS monorepo</p>
+        <h1 className={styles.title}>Contract-first scaffold for NAS mounts and cloud mode.</h1>
+        <p className={styles.copy}>
+          The repo is organized so each system part can be built in parallel
+          without inventing new interfaces. The source of truth is the root
+          contract plus the shared contracts package.
+        </p>
+      </section>
+
+      <section className={styles.grid}>
+        {lanes.map((lane) => (
+          <Card key={lane.title} className={styles.card} title={lane.title} href="/#">
+            {lane.body}
+          </Card>
+        ))}
+      </section>
+    </main>
+  );
+}

apps/web/eslint.config.js

@@ -0,0 +1,4 @@
+import { nextJsConfig } from "@betternas/eslint-config/next-js";
+
+/** @type {import("eslint").Linter.Config[]} */
+export default nextJsConfig;

apps/web/next.config.js

@@ -0,0 +1,6 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  output: "standalone",
+};
+
+export default nextConfig;

apps/web/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@betternas/web",
+  "version": "0.1.0",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "next dev --port 3000",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint --max-warnings 0",
+    "check-types": "next typegen && tsc --noEmit"
+  },
+  "dependencies": {
+    "@betternas/sdk-ts": "*",
+    "@betternas/ui": "*",
+    "next": "16.2.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@betternas/eslint-config": "*",
+    "@betternas/typescript-config": "*",
+    "@types/node": "^22.15.3",
+    "@types/react": "19.2.2",
+    "@types/react-dom": "19.2.2",
+    "eslint": "^9.39.1",
+    "typescript": "5.9.2"
+  }
+}

apps/web/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "extends": "@betternas/typescript-config/nextjs.json",
+  "compilerOptions": {
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "strictNullChecks": true
+  },
+  "include": [
+    "**/*.ts",
+    "**/*.tsx",
+    "next-env.d.ts",
+    "next.config.js"
+  ],
+  "exclude": ["node_modules"]
+}