Changelog
All notable changes documented here. Format: Keep a Changelog. Versioning: SemVer.
[1.0.0] - 22nd May, 2026
Core Architecture & Developer Experience
- Agent-Native Architecture — Integrates Graphify AST-level codebase mapping to eliminate AI agent hallucination and reduce AI token usage by up to 71.5x.
- AI Developer Tooling — Includes dedicated
.agents/skills and workflows alongsideAGENTS.mdandCLAUDE.mdfor zero-hallucination AI-assisted development. - Strict Tech Stack — Utilizes Next.js 16 App Router, TypeScript 6 (Strict), Drizzle ORM, and Zod validation. Guarantees testing parity with 900 unit tests and comprehensive E2E Playwright coverage.
- Interactive Setup Wizard — Provides a robust CLI with interactive prompts, automatic environment variable generation, and manual database bootstrapping instructions. Generates exclusively
.env.localto avoid clutter, wraps special-character values in double quotes, and guarantees clean builds. - Universal Background Jobs — Decouples transport logic into swappable Upstash QStash and Trigger.dev adapters with unified dependency health checks.
- Modular Background Jobs — Decoupled configuration validation (
lib/jobs/config.ts) from dynamic Database/handler pathways to safeguard system health endpoints without side effects. - Performance Optimization — Employs
Promise.allfor parallel database queries, cursor-based pagination, request-level Reactcache(), and dynamic imports to ensure high performance. - Avatar Storage RLS Bypass — Uses service role client for avatar upload URL generation and deletion to bypass
storage.objectsRLS, with session identity validated first. - Middleware Profile Fallback — Profile resolution queries the user-authenticated client first, falling back to service role only when the profile is not found and a valid
SUPABASE_SECRET_KEYis present. - Locale Scoping & Type Integrity — Hardened AI legal page publishing and configuration transitions to isolate workflows completely by locale and type, preventing accidental cross-locale state conflicts.
Design System & UI
- Glassmorphism 2.0 — Delivers premium crystal surfaces (
bg-white/50 backdrop-blur-2xl), tri-font typography (Space Grotesk, DM Sans, Fragment Mono), and OKLCH color tokens. - Touch-First Ergonomics — Enforces strict 44px minimum tap targets, fluid Bento Grid layouts, and iOS safe-area integration for mobile perfection.
- Dynamic Interactions — Features animated GlowCards, emoji loaders, spring-physics collapsible navigation, and smart sticky headers using
motion/react. - Super-Admin Dashboard — Supplies 17 modular management tools for users, billing, support tickets, waitlists, and AI-powered legal document generation, all featuring standardized UI and centralized CSV exports.
- Internationalization (i18n) — Maintains 100% key parity across EN, ES, and FR locales with localized marketing forms and transactional emails.
- Avatar Aspect Ratio — Global
AvatarImageusesobject-cover object-centerfor automatic 1:1 cropping and normalizes emptysrctoundefinedto prevent browser warnings. - Testimonials Network Optimization — Eliminated remote dependencies on external random avatar providers, adopting dynamic high-fidelity CSS-native glassmorphic gradients and initials, alongside an explicitly hardened Next.js
allowedPatternsimage configuration. - Core Web Vitals Tuning — Dynamic progressive loading separates marketing page components into Server and Client lazy wrappers (
BelowFoldSections.tsx) to drastically cut main-thread blocking time.
Security & Authentication
- Enterprise Authentication — Supports passkeys, magic links, OAuth (Google/GitHub), and TOTP MFA with step-up verification, secure email verification, PKCE-style server-side verification, and fail-closed middleware enforcement.
- Email Verification Redirect — Server-side OTP confirmation immediately redirects to
/verified, eliminating duplicate page renders and client-side flash. - OWASP Compliance — Enforces Row-Level Security (RLS) on all 32 tables, strict CSP nonce policies, SSRF URL sanitization, and cryptographic safety (zero
Math.random()in server code). - Edge Rate Limiting — Integrates Upstash Redis to provide route-level rate limiting, brute-force bans, and circuit breakers across 56+ public and authenticated API routes.
- Impersonation Safety — Enables super-admin user impersonation backed by HMAC-signed cookies, auto-expiry, and instantaneous UI layout synchronization.
- Defensive Deletion — Implements fail-closed account deletion to securely cancel all active payment provider subscriptions before wiping user profiles and storage.
Payments & Billing
- Universal Payment Adapter — Integrates Stripe, Polar, Lemon Squeezy, Dodo, and Creem via a single environment variable with retry-safe webhook idempotency.
- Complex Billing Models — Manages subscriptions, usage-based credits, one-time/lifetime purchases, and team seat entitlements natively.
- Checkout Security — Creates guest-safe checkout sessions, prevents external return targets via same-origin validation, and safely fulfills digital products via signed tokens.
- Billing Transparency — Features a high-fidelity billing dashboard to render tiered resource limits dynamically and manage lifetime access serialization.
AI & Intelligence
- Universal AI Adapter — Supports Gemini, OpenAI, Anthropic, and DeepSeek for high-quality chat, intent detection, and structured JSON outputs.
- Google GenAI 2.5.0 Upgrade — Integrated
@google/genaiv2.5.0 SDK, designatinggemini-3.5-flashas primary chat model with robust custom schema mappings for legal page creation. - RAG & Knowledge Base — Deploys a pgvector embedding pipeline (3072-dim) with cosine similarity and a super-admin managed document repository.
- Embeddings Dimension Protection — Standardized embedding processes on
gemini-embedding-2yielding a stable 3072-dimensional vector footprint with explicit runtime boundaries and zero pgvector dimension pollution. - Universal AI Voice Adapter — Supports swappable text-to-speech (TTS) and speech-to-text (STT) services via ElevenLabs and Murf AI with request-time key resolution and integrated SSRF guards for immersive voice conversations in over 29 languages.
- Autonomous Support — Includes an AI chat widget with 100+ language support, lazy conversation creation, and seamless escalation to human support queues via Supabase Realtime.
Platform Features
- Organizations & Multi-Tenancy — Provides full organization RBAC with owner, admin, and member roles alongside tier-based project management limits and invite systems.
- Universal Email Adapter — Wraps SendGrid, Resend, Postmark, and Brevo into zero-code adapters featuring 13 localized transactional React Email templates.
- Universal Analytics Adapter — Supports 9 analytics providers (including Mixpanel, PostHog, Plausible) in a consent-gated, CSP-compliant architecture.
- Affiliate System — Drives growth via built-in referral tracking with IP hashing, cookie-based attribution, and atomic payout management.
️ OWASP Top 10 (2025) — Full Compliance
- ✅ A01 — Broken Access Control — Block SSRF via
lib/security/ssrf.tswith 25+ unit tests - ✅ A02 — Security Misconfiguration — Validate env at build-time; run 9 HTTP header tests
- ✅ A03 — Supply Chain — Run
npm run security:auditin CI; maintain CycloneDX SBOM and Dependabot - ✅ A04 — Cryptographic Failures —
lib/security/crypto.tsreplaces allMath.random()in server code - ✅ A05 — SSRF — Audit LLM prompt injection; defense-in-depth via
ssrf.ts - ✅ A06 — Insecure Design — Maintain STRIDE threat model with 6 abuse case scenarios
- ✅ A07 — Auth Failures — Provide password strength meter and universal MFA across all vectors
- ✅ A08 — Data Integrity — Use SRI hashes on CDN scripts and verify all
JSON.parse()calls - ✅ A09 — Logging & Alerting — Maintain append-only
auth_eventswithlogAuthEvent()and brute-force detection - ✅ A10 — Exceptional Conditions — Enforce fail-closed MFA, production fail-closed rate limiting, payment timeout handling, and graceful shutdown
️ Technical Stack
| Category | Technology | Version |
|---|---|---|
| Framework | Next.js (App Router, RSC) | 16+ |
| Language | TypeScript (Strict Mode) | 6+ |
| Styling | Tailwind CSS | 4+ |
| Components | shadcn/ui | Latest |
| Animation | motion/react (LazyMotion) | Latest |
| Database | PostgreSQL (Supabase) | Latest |
| ORM | Drizzle ORM | Latest |
| Auth | Supabase Auth | Latest |
| Payments | Stripe / Polar / LS / Dodo / Creem | Latest |
| Analytics | Universal Adapter (9 providers) | Latest |
| AI | Universal Adapter (Gemini, OpenAI, Anthropic, DeepSeek) | Latest |
| Voice | Universal Adapter (ElevenLabs, Murf AI) | Latest |
| Vector Search | pgvector | 0.7.x |
| Embeddings | gemini-embedding-2 | Latest |
| Docs | Fumadocs | Latest |
| Validation | Zod | Latest |
| Forms | React Hook Form | Latest |
| Rate Limiting | Upstash Redis | Latest |
| Background Jobs | Upstash QStash + Trigger.dev | Latest |
| Testing | Vitest (Unit) + Playwright (E2E) | Latest |
| API Docs | OpenAPI 3.0.3 + Scalar | Latest |
Role Terminology
| Role | Scope | DB Value | Description |
|---|---|---|---|
super-admin | Platform | 'super-admin' | Global owner — distinct from org roles |
super-admin | Organization | Org membership | Org-level super-admin |
member | Organization | Org membership | Standard org member |
owner | Organization | Org membership | Org creator, full ownership |
user | Platform | Default | Standard authenticated user |
⚠️ Platform
super-adminuses hyphenated format (super-admin, notsuper_admin). All RLS, code, and docs use this consistently.
Copyright © 2026 Vibe44. Built with ❤️ by Scale with Alap.