Iridium
The full-stack AI app starter behind my newer apps: authentication, an agentic AI chat system with tool calling, and the patterns I reuse, so each new app starts on what makes it different.
- Year
- 2025
- Built with
- Links
- See the progress
Overview
Iridium is a production-ready starter kit for building AI-powered applications. Built on React Router with TypeScript and Bun, it ships with a complete agentic AI chat system powered by Mastra, the Vercel AI SDK, and Anthropic, including threaded conversations, real-time streaming, message persistence, and agent tools like note-taking. Authentication is handled by Better Auth with role-based access control (User, Editor, Admin), secure HTTP-only sessions, and user banning. The stack includes PostgreSQL with Prisma, Tailwind CSS with Base UI components, and Docker for deployment. Validated form patterns with React Hook Form and Zod, middleware-based route protection, and strong accessibility practices round out a foundation you can build on immediately.
What I learned
Gained deep expertise in building agentic AI chat interfaces with Mastra, including tool calling, PostgreSQL-backed agent memory, and working memory with Zod-validated schemas. Adopted Bun as the development runtime for faster installs and script execution while maintaining Node compatibility in production Docker builds. Developed strong patterns for combining React Hook Form with Zod for end-to-end form validation. Built accessible, responsive layouts with proper ARIA attributes, focus management, and keyboard navigation.
Why it matters
Iridium is the foundation my newer apps are cloned from, including Fresh Visit. Instead of spending weeks wiring up authentication, database models, and AI integration for each one, I start from a running app with agentic AI chat, secure auth, and production patterns on the first clone. The Mastra-powered agent system demonstrates real-world tool calling with note creation and search. The focused architecture minimizes technical debt while the clean separation of concerns makes it straightforward to extend with your own agent tools and features.
Screens
04 images, select to enlargeHiring a senior frontend engineer?
I'm looking for my next role on a product team, building design systems and AI tooling. The resume has the details, and my inbox is open.