How jobin-s/vayana works
Vayana is a full-stack Next.js (App Router) web application for personal library management with:
• UI pages (dashboard, add/edit book, login/register)
• API routes under src/app/api/** (auth + books CRUD)
• MongoDB via Mongoose models (src/models/*)
• JWT auth (JOSE) stored in HTTP-only cookies
• Client state via Zustand (src/store/useBookStore.ts)
• Middleware for request-time access control (src/middleware.js)
• a server runtime (Route Handlers, Server Actions, Middleware)
• a client runtime (React components + Zustand store)
• a database (MongoDB)
• auth token flow (JWT cookie creation/validation)
Top level
• src/app/**: App Router: pages, layouts, route handlers (API), server actions
• src/components/**: reusable UI components (pure client/view layer)
• src/lib/**:
• db.js: MongoDB connection logic (shared server utility)
• auth.js: JWT creation/verification helpers (server utility)
• src/models/**: Mongoose schemas (Book.js, User.js)
• src/store/**: Zustand store used by the client for UI state
• src/middleware.js: edge/server middleware intercepting requests (auth gate)
UI routes (pages)
• src/app/page.tsx: landing/root
• src/app/login/page.tsx, src/app/register/page.tsx: auth screens
• src/app/(main)/dashboard/page.tsx: main dashboard (list/search/filter)
• src/app/(main)/add-book/*: add book UI + action.ts (server action)
• src/app/(main)/edit-book/[id]/page.tsx: edit book UI
API routes (server endpoints)
• src/app/api/auth/login/route.js
• src/app/api/auth/logout/route.js
• src/app/api/auth/register/route.js
• src/app/api/books/route.js (collection: list/create)
• src/app/api/books/[id]/route.js (single book: read/update/delete)
These should appear as a REST-ish API layer inside the Next.js server boundary.
What to include as “main components”
For this project, break it into as many components as possible while keeping it readable:
Client / Browser layer
• Next.js React UI
• Pages: Login, Register, Dashboard, Add Book, Edit Book
• Components: Header, Navbar, Footer, BookCard, BookList
• Zustand store (useBookStore.ts)
• Holds client-side state: book list, filters/search term, optimistic updates (if used)
Next.js Server layer (same app, different concerns)
• Route Handlers (API) under /api/**
• Auth API: login/register/logout
• Books API: CRUD
• Server Actions
• src/app/(main)/add-book/action.ts (server-side mutations invoked from UI)
• Middleware
• src/middleware.js (auth enforcement / redirects / protecting (main) routes)
Data / Persistence layer
• MongoDB
• Mongoose Models
• User and Book schemas
• DB connection utility
• src/lib/db.js
• JOSE JWT
• HTTP-only cookie
• src/lib/auth.js for sign/verify helpers
• JWT_SECRET and MONGODB_URI from .env.local
Route Handler
• connect db
• User model lookup + password verify (implementation detail)
• auth.js signs JWT
• sets HTTP-only cookie
Flow 3: Auth gate (middleware)
• Browser → request to /dashboard, /add-book, /edit-book/...
• middleware.js:
• reads cookie
• verifies JWT via auth.js
• allow → continue to page
• deny → redirect to /login
Flow 5: Create book (Add Book)
• Server Action path:
1. Book page → calls action.ts (server action)
2. Server action → db → Book model create → returns result
• API path (if used elsewhere):
1. Browser → POST /api/books
2. Route Handler → db → create book
Flow 6: Update/Delete book (Edit Book)
• Browser → PATCH/PUT/DELETE /api/books/[id] (or server action if used)
• Handler/action → db → Book model update/delete
• Response → client updates Zustand store and UI
Client/UI
• src/app/login/page.tsx
• src/app/register/page.tsx
• src/app/(main)/dashboard/page.tsx
• src/app/(main)/add-book/page.tsx + add-book-form.tsx
• src/app/(main)/edit-book/[id]/page.tsx
• src/components/{BookCard,BookList,Header,Navbar,Footer}.tsx
• src/store/useBookStore.ts
Server
• src/middleware.js
• src/app/api/auth/{login,logout,register}/route.js
• src/app/api/books/route.js
• src/app/api/books/[id]/route.js
• src/app/(main)/add-book/action.ts
Domain/Data
• src/lib/db.js
• src/models/User.js
• src/models/Book.js
• src/lib/auth.js
• MongoDB