Changelog

• Edge Kit: dedicated TanStack Start kit with native stack and feature parity
• AI Agents: workflow builder template, tool calling, and MCP support for agentic apps
• AI Kit: message branching in chat, advanced RAG / knowledge base support, and chat canvas
• Billing providers: Chargebee, Creem, and Whop, plus embedded checkouts in the dashboard upgrade flow
• Guides and recipes: More tutorials on how to develop end-to-end features with TurboStarter as a foundation
• ... and countless more fixes, improvements, and optimizations

AI Kit image-generation demos can now use NANO_BANANA_2 and support more aspect ratios. This gives you more flexibility to create images that better fit a square post, portrait layout, or wide banner without changing the rest of your app.

Web apps now use Next.js 16.3.1, following the Next.js 16.3 updates, alongside an updated Better Auth release. The starter's authentication and API types still compile successfully, and the production web build has been verified on the new Next.js version.

No schema changes are included in this update, so most existing projects can apply it directly.

Pages in TurboStarter web apps now respond as soon as someone clicks a link. The next screen appears immediately while account-specific content loads in place, making marketing pages, dashboards, and settings feel much faster.

This is powered by Next.js 16.3 instant navigations. The AI Kit gets the same navigation upgrade and moves to TypeScript 7, whose new native compiler makes type checks much faster during development and in CI.

We also refreshed data tables, loading indicators, calendars, animations, billing integrations, and browser extension messaging. New projects include everything automatically. Existing customers can pull the changes with the updating codebase guide.

Most existing projects can apply the update directly. If you customized the affected components, note these changes before merging:

• Data tables: The starter has migrated to TanStack Table v9. Custom tables may need its migration guide.
• Loading indicators: Rename custom Spin imports to Spinner, following the shadcn Spinner.
• Billing: Review custom Stripe code against the Stripe 22.4 release notes. Dodo Payments users can see the 2.45 release notes.
• Browser extensions: @webext-core/messaging v4 removes the old polyfill to stay compatible with browser messaging changes.

Calendar and animation foundations also move to react-day-picker v10 and Motion 13.

TurboStarter now includes an initial cookie consent experience built with c15t. The footer has been adjusted to make room for consent controls, and analytics providers can be loaded conditionally so tracking only runs in the situations you intend. See the analytics configuration guide when connecting your providers.

Mobile projects can now support push notifications. The setup flow explains permission states more clearly and includes refreshed translations, helping customers understand when and why notifications are enabled.

Web notifications are more consistent too. Toasts, the short messages used for confirmations and errors, now use the shadcn Base UI Toast instead of Sonner.

API errors now prefer explicit HTTP status codes. This prevents failures when an error provides a named status such as FORBIDDEN.

For teams deploying on Cloudflare, newly generated projects can also include a middleware.ts template.

A dedicated waitlist page now helps you collect interest before launch. It includes an email signup form, social links, and localized English and Spanish copy. The marketing navigation links to the new page, and the main landing page now includes a newsletter section.

Visitors receive clearer validation and submission feedback, including a visible status after their email is submitted.

Theme controls now make the starter easier to match to your brand. You can adjust component corner radius, keep that preference across the web app and browser extension, use serif typography, and press t to switch between light and dark mode.

Mailgun is now available for email delivery through its Messages API. Projects using Mailgun's EU region can also point the provider to the corresponding API address.

The interface foundations also add a Progress component for showing billing-period progress. Drawers now use Base UI instead of Vaul to align with the starter's wider component system.

If you customized the previous drawer, review the Vaul to Base UI migration notes.

Mobile apps now have a more current and reliable foundation for native features. Under the hood, TurboStarter moves to Expo SDK 56 and updates related mobile packages together for better compatibility.

Authentication screens now provide clearer feedback for invalid emails and password problems. Better Auth packages were also updated for reliability, and the database is prepared for future two-factor authentication support. A customer-facing 2FA flow is not included in this release.

AI chats can now send locale and platform headers, use cookies for authentication, and resolve dynamic addresses through Expo Linking. These changes make it easier for web and mobile clients to send the right context and connect consistently. The AI Kit also includes smaller bug fixes and configuration updates.

The status bar and navigation bar now adapt correctly when customers switch between light and dark mode.

Existing mobile customers should review Expo's SDK 55 to 56 migration guide for changes that may affect custom Expo Router code.

TurboStarter now prepares web apps for Cloudflare Workers or Docker, giving you more control over where your product runs without wiring each platform from scratch.

The Cloudflare generator sets up OpenNext, connects the web and database configuration, adds a Cloudflare-specific middleware template, and includes foundations for Hyperdrive database connections and R2 object storage:

pnpm turbo gen cloudflare

For container hosting, project generation can now add a production Dockerfile and an optimized .dockerignore. The shared templates keep container setup consistent across projects.

Project creation is more predictable as well. A new pnpm gen script runs Turbo generators, shared environment configuration keeps setup aligned across environments, and initialization now asks for a product name with stronger name validation.

Billing setup can now include Dodo Payments, expanding the payment providers available to web apps.

The release also adds Node.js 24.x support to CLI workflows, updates posthog-js and @sentry/nextjs, and aligns workspaces and the lockfile. Generated projects now ignore .open-next/, .wrangler/, and .dev.vars* while preserving .dev.vars.example as a configuration reference.

Production problems are now easier to find and fix. React error boundaries capture exceptions more reliably, while the PostHog integration automatically records unhandled errors and rejected promises. This gives teams better visibility into unexpected failures without adding tracking to every code path.

Dashboards also get more dependable charts. TurboStarter moves from Recharts 2.15.4 to Recharts 3.8.1, with more consistent tooltips, refined shape rendering, and better responsiveness across screen sizes.

App metadata and icons are now managed through a central manifest.ts file. The starter adds a scalable SVG icon, refreshes the favicon and Apple touch icon, and removes the deprecated icon.png. This makes branding easier to customize and keeps icons consistent across devices.

Local workflows received a few safeguards too:

• .env files are ignored by default to reduce the risk of committing local configuration.
• Pre-commit hooks skip formatting and linting for non-source files.
• The build tool moves to esbuild 0.28.1.

Email-based sign-in, onboarding, and notifications are now easier to test before they reach customers. TurboStarter uses Mailpit to capture emails locally, so you can inspect every message without configuring an external email provider. See the email configuration guide for the wider setup.

Account flows now give customers and developers clearer feedback. Authentication handles anonymous-session errors more explicitly, organization screens explain invalid or missing team IDs, and the related translations use consistent wording throughout the app.

Stripe subscription periods are also calculated and handled more accurately, reducing edge-case inconsistencies in billing dates.

Under the hood, the release updates hono, @hono/zod-validator, and hono-status-monitor, aligns routine dependencies, and moves the Better Auth packages to version 1.6.14.

Account switcher and user navigation menus now use more consistent widths. The improved sizing keeps menu content easier to read, better aligned, and more predictable across screen sizes.

This routine release also updates core dependencies to their latest compatible versions for ongoing stability and ecosystem compatibility.

TurboStarter now supports more ways to package and charge for your SaaS. You can configure plans and tiers, show tiered pricing more clearly, and offer usage-based billing with checkout support. The billing foundation also connects credits with usage tracking.

Organization billing now gives admins visibility into orders and subscriptions. New billing roles, permissions, and permission checks provide finer control over who can view or manage billing.

More payment provider choice

Dodo Payments is now available as a web billing provider. Polar and Lemon Squeezy also have better feature parity, with more consistent billing flows across integrations.

Billing works more consistently on mobile too. This release improves mobile feature parity, fixes mobile permission checks, and strengthens organization and account validation.

We also fixed discount calculations and select menu scrolling, resolved smaller billing and interface issues, cleaned up unused files, and corrected problems with the shadcn CLI integration.

Select inputs now keep a more predictable scroll position when you open or navigate long option lists. This makes choosing from larger datasets feel smoother and less error-prone.

Analytics data collection now supports Firefox more consistently, giving product teams more complete usage insights across browsers.

We also upgraded compatible core dependencies, fixed type inconsistencies, and resolved issues in the React Email integration to improve stability and compatibility.

You can now share AI conversations with teammates, customers, or anyone else through a dedicated share dialog and public chat view. Chat title menus include the new actions, the sharing API is simpler, and "star" has been renamed to "pin" to make chat organization clearer.

Chat history is easier to manage too. Each item now offers Open in new tab and Delete chat actions, backed by cleaner state handling.

Document-based chat can now cite the exact PDF page where information appeared, making answers easier to verify. Search ranking and result selection have also been tuned to return more useful context.

Web search now supports Exa, Brave Search, Tavily, and Firecrawl through one provider-based setup. The web search guide explains when to use each option and how to connect it.

Finding the right AI model is faster as well. Available models now load dynamically instead of coming from a fixed list, and the selector adds search, improved scrolling, mobile refinements, and accessibility fixes.

Chat and image APIs now retrieve data through the signed-in user's context, improving data isolation between customers. Mobile bottom sheets also respond more reliably to the keyboard, making text input smoother.

The drawer and sidebar now use Contact Us instead of Report an Issue, with updated email links and icons. PostHog instrumentation was also added for analytics tracking.

Core dependencies received security fixes, migration issues were resolved, and authentication moved to Better Auth 1.6.0.

Attachments in AI Kit chats and other AI experiences now have cleaner spacing, better alignment, and a more consistent appearance across web and mobile.

Navigation between demo screens is also smoother and more predictable. We fixed shallow navigation issues that could leave route state out of sync when moving between views.

Mobile apps now have a more reliable foundation for native features. TurboStarter moves to Expo SDK 55, keeping native modules current and aligned with the wider Expo ecosystem.

The Metro configuration is simpler too. Legacy monorepo path handling and the unused newArchEnabled flag have been removed.

Authentication packages now use Better Auth 1.5.3, bringing the starter in line with that release's fixes and improvements.

Sign-in emails for one-time passwords now include a direct URL. Customers can use the link or enter the code, making password-free sign-in clearer and more reliable. See the authentication overview for the available sign-in methods.

We also corrected internationalization issues around locale resolution. Language detection and persistence are now more consistent, and authentication screens stay better aligned with the rest of the app's selected language across sessions.

PostHog, repository-wide dependencies, and email package dependencies have been refreshed. Prettier formatting runs are faster, and the Vercel deployment provider has been updated.

Existing customers with custom native dependencies or Metro settings should review the Expo SDK 55 release notes and Expo upgrade walkthrough when bringing these changes into an app.

OpenClaw instance management can now handle pairing and device workflows through CLI commands connected directly to the dashboard. You can also inspect logs from the instance management screen, making it easier to understand what a running instance is doing without leaving the dashboard.

Status changes now appear more reliably across the interface. The underlying instance hooks refresh status data after a change, while pairing and device actions use the new command integrations.

The OpenClaw configuration structure was also consolidated to remove duplicate imports. Its documentation now uses the updated VPS log retrieval command and removes the outdated VPS deployment guide.

Member roles are now validated more consistently across organization components. This reduces edge cases when showing role-specific controls or checking whether a member can perform an action.

In the AI Kit, conversation and markdown components now render more reliably.

Images are now prefetched where appropriate, so generated and remote images can appear sooner. This also makes transitions smoother and reduces layout shifts in image-heavy screens.

The AI Kit now provides a shared set of interface components for building AI experiences across web and mobile. Chats stay anchored to the latest message, attachments are easier to add and validate, and loading and error states give users clearer feedback.

These components now power the chat demo and updated RAG, image generation, and text-to-speech demos. RAG, or retrieval-augmented generation, lets an AI answer with information from your own sources.

The new building blocks include:

• A prompt input with drag-and-drop uploads, attachment validation, media-aware file handling, toggle options, and a simpler action menu
• User and assistant messages with copy and feedback actions
• Model selectors for chat and text-to-speech
• Mobile loading shimmers and shared smaller UI components for a consistent experience

Clearer conversations and composers

The conversation structure now handles loading and errors more cleanly. Active chats stay at the bottom as new messages arrive, scrolling and layout issues have been corrected, and web messages have a cleaner presentation. Mobile now has dedicated components for context, reasoning, tool activity, and model selection.

The composer has clearer placeholder and status text, improved accessibility, and toast notifications through sonner-native. The text-to-speech composer also adds model selection, voice settings, a clearer layout, and stronger feedback states. Image generation components now use the same shared system, with unused code removed. The chat, PDF, image generation, and text-to-speech demos all receive related refinements.

This release also updates the database schema, brings related scripts into parity, adjusts the chat API, and refactors markdown rendering with react-native-enriched-markdown. Unused components and dependencies were removed alongside broader performance and structural cleanup. AI Kit is now version 1.2.0.

The TurboStarter CLI can now handle more of project setup and ongoing management for you. New project management commands reduce manual work, while initialization can configure providers and prepare the environment around your choices.

Setup and updates are more reliable too:

• File changes now account for more edge cases in configured apps.
• Errors and logs give clearer information when something goes wrong.
• Git configuration and repository URL handling work more smoothly with automated workflows.

Start a new project with the latest CLI:

npx @turbostarter/cli@latest new

Analytics now loads more reliably when a TurboStarter app starts. We fixed an edge case in the PostHog integration that could interfere with initialization.

The AI Kit has also moved its shared components and demo forms to Base UI. Web and mobile forms now follow the same patterns, with mismatched form properties found during the migration corrected. This gives the demos a more consistent interface across platforms and a cleaner foundation for future customization.

We also refreshed the AI agents, skills, and commands used by Core and AI Kit, and synchronized Envin's version packages so its published artifacts stay aligned.

Navigation, forms, charts, and modals now feel more consistent across web and mobile. Behind the interface, web components move to the shadcn Base UI foundation, while forms on both platforms share the same field structure.

Navigation is clearer throughout the product:

• Sidebars have more consistent layout and spacing.
• Web top navigation aligns correctly.
• Breadcrumbs communicate hierarchy and interaction more clearly.
• Mobile menu fixes make hamburger navigation more reliable.

Chart and badge colors now match the updated interface, mobile charts are easier to read, and legacy images have been replaced. Modal fixes prevent layout issues, while smaller CLI fixes improve day-to-day reliability. These visual changes do not alter your underlying data or product behavior.

If you customized the affected components, compare your changes with the Base UI versions before updating.

Your backend can now react to mobile subscription events as they happen. Webhook callbacks cover events such as renewals and status changes, giving you clearer visibility and helping billing state stay in sync with existing backend workflows. See the mobile billing webhook guide.

The AI Kit demos now use Uniwind for a cleaner, more consistent styling foundation. Theme colors and components share the new system, error boundaries make runtime failures safer, and translation issues and smaller inconsistencies have been fixed.

Envin's CLI now supports more options and multiple environment entries, making complex configurations easier to manage. Config file paths behave more predictably, and the --cascade option has been removed to simplify the command surface.

If you customized AI Kit styles, compare your overrides with the Uniwind migration guide. If custom scripts use Envin's removed --cascade option, update them before pulling this release.

Customers can now manage billing across both your web and mobile apps. The shared foundation keeps plans and payment status consistent, while clearer configuration and more reliable provider integrations reduce the work needed to launch subscriptions.

• Mobile: Customers can view subscriptions, orders, billing details, and their active plan. Onboarding can include a built-in paywall step.
• Web: Customers get subscription and order views, clearer empty states, a simpler current-plan display, and links to the billing portal.
• Integrations: Stripe, RevenueCat, and Superwall event handling is more reliable. Configuration and SDK setup now live in one place, and mobile apps get a usePaywall hook for custom purchase flows.

Super admins can see customer billing information more clearly. We also simplified billing and API schemas, expanded test coverage, and moved API requests to shared TanStack helpers.

The API monitor now includes the Hono service status, email themes can be configured through environment variables, and internal package names have moved from @turbostarter/* to @workspace/*.

Explore the web billing guide and mobile billing guide. If you import internal packages in custom code, update those imports to the new @workspace/* names.

Database health checks now report connection problems more accurately, reducing false downtime signals and making real issues easier to spot.

Envin also moves fumadocs-mdx from 14.1.0 to 14.2.4 and esbuild from 0.25.12 to 0.27.2 for compatibility, security, and tooling fixes. Preview deployment fixes and general maintenance are included.

No breaking changes are expected from these updates.

Managing teams now takes fewer steps on web and mobile. Member and invitation lists include context menus for common actions such as editing a member, removing access, or resending an invitation without leaving the list.

The same interaction pattern now works across both platforms. On mobile, long-press a member or invitation to open its actions.

This release also includes Android fixes, more reliable form dropdowns and selection controls, routine dependency updates, and cleaner browser extension logs.

Logs now follow one consistent format across the platform, making problems easier to trace. Analytics providers that support customer identification also receive identity updates more reliably, so activity is connected to the right customer journey.

The shared logger providers and output have been simplified, while Envin receives minor dependency updates plus fixes for Node.js tooling and esbuild.

The starter requires no additional configuration. For custom onboarding flows, use @workspace/shared/logger for logs and analytics.identify() when a customer becomes known.

Resent team invitations now reach the right onboarding flow more reliably, helping invited users join without being sent through the wrong setup. See the invitation guides for web and mobile.

We also corrected the default isAnonymous value used when creating sample database records, so newly seeded projects start with the intended account state.

Routine dependency updates improve stability and security. No action is required.

Sign-ins and sessions now handle more edge cases reliably. The Core Kit has moved to Better Auth 1.4, which includes fixes for authentication and session management.

A new automated test suite also checks shared utilities, authentication, and billing code. It produces coverage reports for critical modules, helping catch regressions before they reach your customers.

Better Auth 1.4 includes breaking changes for some custom configurations. If you changed the starter's authentication setup, review the official migration notes before updating.

TurboStarter mobile apps can now receive eligible updates without asking customers to download another version from the app store. These over-the-air updates let you deliver changes to the app's core logic more smoothly.

Organization and team data also stays current more reliably. We fixed how organization lists refresh after changes, reducing stale information across devices.

See the mobile updates guide for how over-the-air releases fit into your publishing workflow.