Project Structure
Understand the core architecture and directory structure of the project.
RSC + Server Actions architecture. Minimal client JavaScript. Server does the heavy lifting. Database enforces security at the row level.
Browser → Next.js route
Middleware (proxy.ts) → IP ban → rate limit (fail-closed in
production) → HMAC-bound CSRF (1-hour TTL, authenticated page-route seeding)
→ session refresh → MFA enforcement (fail-closed) → feature flag redirect →
route auth
Server Component → renders with Supabase data (RLS-enforced isolation)
Server Actions → auth check → Zod validation → Drizzle query →
revalidatePath() + revalidateTag(..., "max")
Webhooks → HMAC-SHA256 verified → durable event ID required → retry-safe
webhook_logs claim → provider-resource upsert/dedup → synced to DB
Performance Posture
Production config avoids unstable Next.js flags; independent reads parallelize
via Promise.all(); Drizzle reads use explicit projections; webhook
super-admin lists clamp to 100 rows; hydration-stable ChartContainer;
fixed-aspect next/image assets preserve intrinsic ratios with explicit auto
sizing.
.env.example (Environment variables template)
.env.local (Local environment variables)
.gitignore (Specifies intentionally untracked files to ignore)
.graphifyignore (Exclusions for Graphify knowledge graph)
.npmrc (NPM package manager configuration)
AGENTS.md (Documentation for AI agents and their capabilities)
CHANGELOG.md (Documenting new features & bug fixes for each version of Vibe44)
CLAUDE.md (Instructions and guidelines for Claude AI interactions)
components.json (Configuration for shadcn/ui components)
drizzle.config.ts (Drizzle ORM configuration for database schemas)
eslint.config.mjs (ESLint configuration for code linting rules)
instrumentation-client.ts (Client-side observability and telemetry setup)
instrumentation.ts (Next.js server-side instrumentation hook)
LICENSE.md (Project open-source or proprietary license terms)
mdx-components.tsx (Custom React components mapping for MDX files)
next.config.ts (Next.js framework configuration options)
package.json (Project metadata, scripts, and dependency definitions)
playwright.config.ts (Playwright end-to-end testing configuration)
postcss.config.mjs (PostCSS configuration, mainly for Tailwind CSS)
proxy.ts (Custom API or proxy server logic setup)
README.md (Main project overview, setup instructions, and details)
sbom.json (Software Bill of Materials listing dependencies and licenses)
sentry.edge.config.ts (Sentry error tracking configuration for edge runtime)
sentry.server.config.ts (Sentry error tracking configuration for server runtime)
source.config.ts (Fumadocs source configuration for content fetching)
trigger.config.ts (Trigger.dev configuration for background jobs)
tsconfig.json (TypeScript compiler configuration)
vitest.config.ts (Vitest configuration for unit testing)
Copyright © 2026 Vibe44. Built with ❤️ by Scale with Alap.
