Evensiva Documentation
Project documentation for Evensiva Technologies — fullstack Next.js 16 application.
Prefer the marketing hub? Documentation (site guides)
Getting Started
Architecture overview and project orientation.
- Architecture overview
Fullstack SSR architecture: tech stack (Next.js 16, MUI v6, @mui/material-nextjs v7), project structure, UI branding (Banner/Footer wordmark), flex main layout (sticky footer), auth routes (`/admin/login`, `/admin/signup`) and signup API route, UI spacing and motion patterns, rendering strategy, client vs server components, routing, data flow, styling, and build output.
- Documentation index (README)
Index and guidelines for using and adding docs.
Features
Platform features and component documentation.
- Platform features overview
Public pages, global Banner/Footer (scroll-aware header with Sign In/Sign Up actions, footer contact icon wells), root layout sticky footer, home hero/stats/services/process/CTA, blog and course UX, documentation/help card layout, contact form, SEO, and admin area including login/signup/register flows.
- Ported components from Codevensiva
Components and patterns ported from Codevensiva: RichContent (DOMPurify + PrismJS + copy buttons), RoutableTabs (URL-synced tabs), ArticleTocSidebar (scroll-spy TOC), documentation/help pages, and adapted admin auth UX (login/signup + optional social auth).
Setup & Deployment
Environment, database, authentication, and hosting guides.
- Environment & deployment guide
**Start here to go live.** Neon (`DATABASE_URL`), detailed `.env.local`: NextAuth, optional OAuth (Google/GitHub + public feature flags), admin seed credentials, Vercel setup with domain + DNS, Edge middleware size notes, checklist, Prisma/Neon reference, and troubleshooting (including `_middleware` and social auth setup issues).
- Database & Prisma guide
PostgreSQL schema design: User (bcrypt, Role enum), Post (slug, HTML content, published status), Course (pricing, schedule), Contact (isRead). Prisma Client singleton, API route patterns (Zod validation), server component direct queries with static fallback, seed script (idempotent upsert).
- Authentication guide
NextAuth.js v5 with Credentials + optional Google/GitHub OAuth, JWT/session callbacks synced from Prisma, shared `auth.config.ts` for Edge, `auth.ts` for provider logic, slim middleware for Vercel, admin login/signup UX, register API, and full auth flow.
Guidelines & Standards
Documentation and coding standards.
- Docs HTML style guide
Dark theme design system for all HTML docs: colors, fonts (DM Sans + JetBrains Mono), sidebar + main grid layout, CSS classes, head/body templates, and rules for new docs.
Archive
Historical migration and completion records.
- Vite → Next.js migration record
Complete migration record: before/after comparison table, all files deleted (Vite infrastructure + old pages), all files created (App Router pages, admin panel, API routes, backend, providers, SEO, ported components), components modified (use client + import updates), 8 build errors fixed during migration, plus a Stack upgrades section (Next.js 16, @mui/material-nextjs v7, home page split, RSC/MUI patterns).