How khuongduy354/unsleepable works
Project type and purpose
• From the file tree and README, this is a full-stack web application built with Next.js (app router) and TypeScript, using Supabase (PostgreSQL + Auth) as its backend.
• It provides user authentication (login, register, OAuth via Google) and a “post” API for creating/reading content.
File structure
• Top-level:
• next.config.ts, tsconfig.json, package.json – build & config for Next.js + TS
• public/ – static assets
• middleware.ts – global auth or routing middleware
• src/app/ – Next.js App Router pages & API routes
· src/app/page.tsx, layout.tsx, globals.css – root layout & styling
· src/app/auth/… – login, logout, signup pages & UI components
· src/app/api/auth/… – auth callback handlers
· src/app/api/post/route.ts – CRUD API for posts
• src/lib/ – core business & infrastructure code
· services/post.service.ts – domain logic
· repositories/supabase.repository.ts – DB abstraction
· auth-actions.ts – helpers for login/register flows
· setup/… – environment and production setup
· types/ – domain TypeScript types
• src/utils/supabase/ – raw Supabase client and server wrappers
• Architectural patterns:
• “App Router” for pages + API routes
• Layered approach: UI → services → repositories → Supabase
• Middleware for auth enforcement
Detailed capture of essential elements
• UI Components (SignInWithGoogleButton, LoginForm, etc.)
• Next.js App Router pages (page.tsx under /auth, /post, root page)
• API Route handlers (route.ts files)
• Middleware.ts (global auth guard)
• Domain Services (post.service.ts)
• Repositories (supabase.repository.ts)
• Supabase client utils (client.ts, server.ts, middleware.ts)
• External: Supabase Database + Supabase Auth + Google OAuth
Putting it all together:
[User Browser]
│
▼
[Next.js App Router] ──(middleware.ts)
• Pages & Components
• fetch("/api/post")
│
▼
[API Routes (/api/auth, /api/post)]
│
▼
[Domain Services Layer]
• auth-actions.ts
• post.service.ts
│
▼
[Repositories Layer]
• supabase.repository.ts
│
▼
[Supabase Infra]
• PostgreSQL
• Auth (JWT)
• OAuth Google