Welcome to Iridium

Iridium includes a fully functional dashboard with real metrics, thread management, and a working AI chat interface. Every button click, every message sent, every thread created triggers PostHog events. See exactly how to instrument your features by reading production code that actually works.

Built with Vercel AI SDK and OpenAI, the chat interface demonstrates streaming responses, multi-turn conversations, and tool calling patterns. Messages persist to your database, threads organize conversations, and the @posthog/ai wrapper tracks token usage and costs automatically. Copy the implementation, adapt it to your product, and ship AI features in hours instead of weeks.

From database schema to API response to UI component, every piece is type-safe. Prisma generates types from your schema, Zod validates runtime data, React Router 7 types your routes, and CVA ensures type-safe component variants. Catch errors at build time, not in production. Refactor with confidence knowing TypeScript has your back across the entire stack.

Iridium ships with Google and GitHub OAuth fully integrated and ready to use. No configuration guesswork—just add your OAuth credentials to your environment variables and users can sign in with their existing accounts. Email/password authentication is also included with secure session management and role-based access control built-in.

BetterAuth supports 35+ OAuth providers including Apple, Discord, Facebook, LinkedIn, Microsoft, Spotify, Twitch, and more. Adding a new provider is straightforward—install the plugin, add credentials, and update your auth configuration. The patterns are already established in the codebase, so extending to other providers takes minutes, not hours.

7-day secure sessions with HTTP-only cookies, CSRF protection, and automatic session refresh. BetterAuth handles the security complexity while giving you full control over user data and authentication flows. All session helpers (requireUser, requireAnonymous) are implemented and documented in the middleware patterns.

Toggle features on and off without deployments. The admin panel integrates with PostHog for real-time feature flag control, A/B testing, and gradual rollouts. Test new features with a subset of users, roll back instantly if needed, and iterate faster with confidence.

Quick access to theme switching, form demos, and component galleries. The admin panel serves as a central hub for developers to test UI variations, preview components, and manage application settings without touching code. Links to external services like Polar.sh keep everything in one place.

Test every component variant in isolation with the built-in design system preview. See all button styles, form states, and UI patterns at once. Perfect for validating design decisions, testing accessibility, and ensuring consistency across your application without hunting through routes.

Every meaningful action—sign-ups, thread creation, message sends, tool calls—automatically tracked. No guessing about user behavior. PostHog events are instrumented throughout the codebase, so you can see patterns like which features drive retention and where users get stuck.

Toggle features on and off without deploying. Run A/B tests to validate product decisions before committing. This landing page uses feature flags right now—different hero images and copy variants served to different users, measured in real-time.

The @posthog/ai wrapper captures every AI interaction: model used, tokens consumed, estimated cost, latency. See which prompts work, which tools get called, and how much your AI features actually cost—without manual logging.

Watch user sessions to understand confusion and bugs. Automatic exception capture with stack traces means you know about issues before users report them. Debug with context instead of guessing from error messages.

Over 30 instruction files in .github/instructions/ document every pattern: CVA component variants, form validation, CRUD operations, authentication flows, error boundaries, feature flags, and more. Each guide includes working examples, anti-patterns to avoid, and TypeScript best practices. You're not just getting code—you're getting the accumulated knowledge of how to use it correctly.

The docs/ folder contains deep-dives on every integration: AI implementation with tool calling, authentication patterns, deployment guides, testing strategies, and architectural decisions. Each document explains the 'why' behind technical choices and provides step-by-step implementation guides. Learn by reading production-quality documentation that anticipates your questions.

The docs/decisions/ folder documents why we chose React Router 7 over file-based routing, BetterAuth over Clerk, Prisma's custom output path, and CVA for component variants. Understanding the reasoning behind architectural decisions helps you make informed choices when extending or modifying the codebase. It's the context most starters never provide.