How hiaayush30/socially works
Project Type and Purpose
• A Next.js front-end (src/app + src/components) serving both static and server-rendered pages.
• Next.js API routes under src/app/api providing the backend microservices.
• Prisma for ORM and migrations (prisma/schema.prisma + prisma/migrations).
• NextAuth for authentication (src/app/api/auth).
• UploadThing for media uploads (src/app/api/uploadThing + src/lib/uploadThing).
• A relational database (Postgres, MySQL, or similar) behind Prisma.
• External services: OAuth identity providers, cloud storage for images.
File Structure
• Top-level files: package.json, next.config.ts, tsconfig.json, lint/build configs.
• prisma/: database schema + migrations.
• public/: static assets.
• src/app/: Next.js “app router” pages—with nested (auth) and (protected) folders to enforce authentication boundaries.
• src/app/api/: segmented route handlers per domain (post, user, auth, health, uploadThing).
• src/components/: shared UI React components (landing, dashboard, profile, UI primitives).
• src/lib/: low-level abstractions (db connection, uploadThing setup, utility functions).
• src/types/: TypeScript definitions (API responses, NextAuth, Prisma schema types).
Relationships & Data Flows
• User → Next.js Page (SSR or CSR) → if data needed, Next.js calls internal API Route
• API Route → Prisma Client → Database → returns JSON
• Frontend JS consumes JSON, renders UI
• File upload: Frontend → UploadThing client lib → API Route issues signed upload URL → client → cloud storage → store image key in DB via another API call.
• Auth: Frontend → NextAuth client → API Route (/api/auth) → NextAuth callback → DB (sessions, users) → issue JWT/cookie → subsequent requests carry session.
Architectural Patterns & Design Principles
• Separation of concerns: UI vs API vs Data layer
• JAMstack-style (pre-rendered pages + API microservices)
• “App router” file-based routing in Next.js
• Prisma for type-safe DB access and migrations
• Modular API routes (domain-driven grouping: post, user, uploadThing)