Changelog

• AI Kit: Agents workflow builder template, branching off messages in chat and advanced RAG support
• Billing improvements: Credits system, usage based billing, per seat, organization billing and many more
• Core customizability: Improving customization options for the core app, including adding new components and themes.
• 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

This update brings meaningful upgrades to the AI kit experience, along with important core improvements under the hood.

Shareable chats

You can now share conversations with a dedicated share flow and public view.

What’s new:

• Title menu actions in chat
• Share dialog UI
• Simplified share API
• Public shared chat view
• Rename “star” → pin for clearer chat organization

These changes make it easier to collaborate, showcase AI outputs, or send conversations to teammates.

Smarter RAG with page-level citations

The retrieval pipeline has been significantly enhanced to improve answer quality and traceability.

Highlights

• Added page-level metadata to embeddings
• Extract page numbers from PDF chunks
• Return page numbers in findRelevantContent results
• Improved system prompt with structured search guidance
• Raised similarity threshold (0.3 → 0.35)
• Increased result limit (6 → 8)

This enables clearer citations and more precise answers for document-based queries.

Dynamic model fetching

Model selection is now powered by a dynamic API.

• New models API route
• API now handles dynamic model resolution
• Search input in model selector
• Improved scrolling and layout handling
• Mobile-specific selector adjustments
• Accessibility fixes

This makes it easier to plug in and switch between available LLM providers without hardcoding options.

Enhanced web search providers

Web search has been refactored into a more flexible provider-based architecture.

Supported providers:

• Exa
• Brave
• Tavily (refactored strategy)
• Firecrawl

User-scoped chat & image APIs

Chat and image APIs now retrieve data using the authenticated user context.

• User ID parameters added to relevant API functions
• New utilities for user-specific chat messages, documents, and image generations
• Refactored routes for clearer data boundaries

This improves data isolation and overall security.

Chat history improvements

Chat history items now include dropdown actions:

• Open in new tab
• Delete chat

The list item implementation was refactored to better separate concerns and improve state handling.

Mobile bottom sheet improvements (core)

We refined the mobile bottom sheet behavior:

• Better layout and interaction adjustments
• Improved keyboard awareness using the keyboard controller

This results in smoother input handling on mobile devices.

Contact & analytics updates

• “Report an Issue” renamed to Contact Us in drawer and sidebar
• Updated email links and icons
• PostHog instrumentation client added for analytics tracking

Dependency & auth upgrades (core)

• Upgraded to better-auth 1.6.0
• Bumped dependencies for security fixes
• Fixed migration issues

These updates keep TurboStarter secure and aligned with the latest ecosystem improvements.

Overall, this release improves collaboration, retrieval quality, model flexibility, search capabilities, mobile UX, and platform security — while continuing to clean up and modernize the foundation.

This update focuses on refining the experience across the AI kit demo apps, with visual improvements and navigation fixes that make interactions smoother on both web and mobile.

Improved attachment styling (mobile + web)

Attachments now render more consistently across devices.

What’s improved:

• Better visual alignment and spacing
• More consistent appearance between mobile and web
• Cleaner presentation inside chat and AI-driven interfaces

These refinements make sharing files and viewing attachments feel more polished and reliable in demo apps like the chatbot and other AI experiences.

Fixed shallow navigation issues

We resolved issues related to shallow navigation that could cause unexpected behavior when moving between views.

✅ Navigation now behaves more predictably
✅ Improved state handling when switching routes
✅ Smoother transitions across demo screens

Minor fixes & version updates

• Updated internal version numbers
• Applied small stability improvements across the repository

While subtle, these changes help keep the AI kit demos stable, consistent, and ready for further iteration.

Expo SDK 55 is now live

TurboStarter’s mobile foundation has been upgraded to Expo SDK 55.

• Better long-term compatibility with the Expo ecosystem
• Improved stability across native modules
• A cleaner base for future mobile features

We also simplified the Metro configuration by removing legacy monorepo path handling and cleaned up unused flags like newArchEnabled.

Improved authentication & email handling

Better Auth v1.5

Authentication packages have been upgraded to Better Auth 1.5, ensuring compatibility with the latest fixes and improvements.

Sign-in OTP email improvements

The sign-in OTP email template now includes a direct URL, making magic-link and OTP-based flows clearer and more reliable for end users.

More reliable i18n locale handling

We fixed inconsistencies in the i18n configuration related to locale resolution.

Improvements include:

• Correct locale detection
• More consistent language persistence
• Better alignment between auth and app-level locale state

This results in more predictable multilingual behavior across sessions.

Analytics & internal improvements

• Updated PostHog integration
• Dependency refresh across the repository
• Email package dependency updates
• Prettier performance improvements (faster formatting runs)

While mostly internal, these changes improve maintainability, developer experience, and long-term stability across TurboStarter.

OpenClaw kit

This release introduces the foundation for Stripe-powered billing, subscription enforcement, and expanded deployment support.

Stripe billing integration

OpenClaw now includes a dedicated billing package with Stripe configuration.

New capabilities:

• Billing package integrated into the application
• Billing API wired into the dashboard deployment form
• Subscription management enhancements
• Active subscription enforcement for:
  • status routes
  • logs routes

Multi-provider deployment support

You can now deploy OpenClaw instances across multiple providers:

Additional improvements:

• Enhanced log retrieval across deployment providers
• Improved instance status handling and UI actions
• Refined pairing flow with dedicated API routes
• Loading states and empty-request handling in the pairing UI

Dashboard updates

• Updated dashboard layout
• New Settings page
• New Agents page
• Billing configuration improvements

Core

More reliable organization role checks

We’ve refined how member roles are validated across organization components. This improves consistency and reduces edge cases when rendering role-based UI or performing permission checks.

AI kit

Conversation & markdown component refinements

The conversation and markdown components have been refactored for better structure and maintainability. This results in cleaner rendering logic and a more robust foundation for AI-powered interfaces.

Image prefetching across components

Images are now prefetched across AI components where applicable.

What this means for you:

• Faster perceived loading times
• Smoother transitions when displaying generated or remote images
• Reduced layout shifts in image-heavy views

Minor fixes

A set of small fixes and polish improvements to keep the AI kit stable and predictable.

OpenClaw kit

This release brings meaningful improvements to instance management and dashboard workflows.

Pairing & device management via CLI

You can now handle pairing and device management directly through new CLI command integrations in the dashboard.

Logs in instance management

Instance management now includes logs functionality, making it easier to inspect and debug running instances directly from the dashboard.

Smarter status updates

Instance hooks have been updated to properly invalidate and refresh status queries. Status changes now propagate more reliably across the UI.

Configuration cleanup

Configuration imports have been consolidated to simplify the internal structure and reduce duplication.

Documentation updates

• Removed the outdated VPS deployment setup guide
• Updated the log retrieval command for the VPS provider
• General documentation cleanup and improvements

Overall, this update focuses on stronger permission handling in core, smoother AI media experiences, and more powerful, CLI-enabled instance management in OpenClaw.

AI kit

We’ve introduced a comprehensive set of AI elements and significantly improved the chat, PDF, image generation, and TTS demo apps.

New AI elements foundation

A new collection of reusable components designed specifically for AI interfaces:

• Prompt input with integrated dropzone support
• Attachment handling with validation and clearer error states
• User & assistant message components
• Message actions (copy, feedback)
• Model selector components (chat & TTS)
• Shimmer/loading states for mobile
• Shared atomic UI components for consistency

These elements now power:

• ✅ Chat app
• ✅ RAG app (migrated)
• ✅ Image generation app (migrated)
• ✅ TTS app (enhanced composer)

Chat experience improvements (web & mobile)

The chat interface has been refactored for clarity, flexibility, and performance.

Conversation & layout

• Improved conversation structure and loading/error handling
• Sticky-to-bottom behavior for active chats
• Better scroll handling and layout fixes
• Cleaner message layout on web
• Mobile-optimized components (context, reasoning, tools, model selector)

Composer enhancements

The chat composer is now more capable and resilient:

• Attachment validation and media-type-aware file handling
• Toggle options and streamlined action menu
• Improved placeholder text and status handling
• Better accessibility
• Toast notifications via sonner-native

TTS & image generation upgrades

The TTS composer now includes:

• Model selection
• Voice settings
• Improved UI structure and feedback states

Image generation components were streamlined and aligned with the new AI elements system, reducing unused code and improving maintainability.

Under the hood

• Database schema updates and script parity improvements
• Chat API adjustments
• Refactored markdown handling (including react-native-enriched-markdown integration)
• Removed unused components and dependencies
• General performance and structural cleanup
• Version bump to 1.2.0

Overall, this release significantly upgrades the AI development experience—especially for chat-based apps - while keeping the core platform lean and up to date.

CLI

This release focuses on making the TurboStarter CLI more capable when setting up and managing projects, while also improving reliability and diagnostics.

Highlights

• ✨ New project management commands to help you manage TurboStarter projects directly from the CLI.
• ⚙️ Smarter project initialization with configurable providers and improved environment setup.
• 🧠 Enhanced file modification logic for configured apps, reducing edge cases during setup and updates.
• 🛠️ Improved error handling and logging, making issues easier to understand and debug.
• 🔧 Refined Git configuration and repository URL handling for smoother automation.

npx @turbostarter/cli@latest new

If you rely on the CLI for scaffolding or ongoing project management, these changes should make everyday tasks feel more predictable and polished.

Core platform

We’ve expanded and refined the authentication flow to support more sign-in scenarios while smoothing out rough edges.

• ✅ Google One Tap is now available for web authentication, enabling faster, low-friction sign-ins.
• ✅ Added email-based OTP as an additional authentication option.
• 🛠️ Fixed type issues uncovered during auth updates.
• 🧭 Resolved scroll-related quirks in auth flows for a smoother user experience.
• 🔄 Updated internal dependencies as part of routine maintenance.

AI kit

Base UI migration completed

All AI demo apps are now aligned on the new Base UI foundation, improving consistency and long-term maintainability.

CLI

Reliability and release housekeeping

File removal now works consistently across platforms, improving the CLI experience on Windows, macOS, and Linux.

Core platform

Analytics stability

• Fixed an issue with PostHog initialization, ensuring analytics load more reliably and avoiding edge cases during app startup.

Internal maintenance

• Ongoing housekeeping around AI agents, skills, and commands to keep internal tooling consistent and easier to evolve.

AI kit

Base UI migration

The AI kit demo apps have been upgraded to the new Base UI system, improving consistency and maintainability across platforms:

• ✅ Migrated shared UI components
• ✅ Updated web forms to the new Base UI patterns
• ✅ Updated mobile forms for parity with web
• 🛠️ Fixed form prop mismatches discovered during migration

Maintenance

• Routine updates to AI rules, skills, and commands to keep demos and tooling aligned.

Envin

Release housekeeping

• 📦 Version packages updated as part of a standard release process, ensuring published artifacts stay in sync.

If you rely on analytics or use the AI kit demos, this update should feel smoother and more consistent right away.

Base UI is now used across core web components for better consistency, maintainability, and type safety. Forms are standardized around a shared <Field /> component; mobile views use the same field system. Type issues uncovered during the migration have been resolved.

Navigation has been refined across layouts:

Visuals: Chart color palettes and badge colors have been updated to match the new UI system. Mobile charts are adjusted for readability; legacy images have been replaced. Modal component fixes prevent layout issues; minor CLI fixes improve day-to-day reliability. These changes focus on clarity and consistency without changing underlying data or behavior.

Mobile billing now supports webhook callbacks so your backend can react to subscription events (renewals, status changes) in real time. You get better visibility into mobile subscription events, more reliable billing state sync, and easier integration with existing backend workflows.

AI kit: Demo apps have been migrated to uniwind for a cleaner, more consistent styling foundation. Theme colors and components use the new system; error boundaries improve runtime stability; translation issues and small inconsistencies have been fixed. If you've customized AI kit styles, review your overrides against the new uniwind tokens.

Envin: The CLI has been extended for more flexible configuration:

Anonymous account deletion is now supported. You can delete accounts created anonymously, with a dedicated handler and more reliable removal flows—same capability as for registered users.

Mobile: A crash caused by the theme on mobile devices has been fixed for more stable behavior on smaller screens.

AI kit: Models updated to the latest supported versions, internationalization improved, and a logger added for debugging. The demo apps are more robust and easier to maintain.

CLI: Mobile billing support added to the TurboStarter CLI. Internal build system migrated to tsdown for faster, cleaner builds; package versions released and aligned.

Envin & internal packages: Migrated to tsdown, dependencies updated, lockfile and documentation tooling improved. Build speed and maintainability are better across the stack.

Billing is now supported on both mobile and web with shared foundations, clearer configuration, and more reliable provider integrations.

• Mobile: Subscriptions, orders, billing details, and active plan display; paywall step in onboarding
• Web: Subscriptions view, orders list, billing empty states, simplified current-plan display
• Providers: Stripe and RevenueCat/Superwall webhooks refactored; centralized config and unified SDK init; new usePaywall hook for mobile flows

Under the hood: Billing schema and API schemas simplified, better customer visibility for super admins, billing portal links, and expanded test coverage. API requests use shared TanStack helpers, Hono monitor status added, email theme configurable via env, and internal packages migrated from @turbostarter/* to @workspace/*.

Core: The database healthcheck is more reliable and accurate, with fewer false positives for downtime. Health monitoring for the database connection has been improved so you get clearer signals when something is wrong.

Envin: Dependencies have been bumped for compatibility and security:

• fumadocs-mdx release notes
• esbuild changelog

No breaking changes expected—these are safe minor bumps. Preview deployment fixes and general maintenance are included.

Context menus are now available on mobile and web for member and invitation lists—quick actions (edit, remove, resend invite) without leaving the list. Member and invitation management use the same patterns on both platforms.

On mobile, long-press members or invitations to open the new context menus. Dependency updates and logging improvements are included for stability and easier debugging.

Monitoring now runs across web, mobile, and browser extension environments. Error screens are unified so users and developers get a consistent experience when something goes wrong; monitoring providers have been refactored for better reliability.

You can identify and resolve issues regardless of platform, with consistent error reporting. See the TurboStarter core monitoring documentation for implementation details.

A unified logging system streamlines log output across the platform. Analytics identification is improved so user identity is handled consistently across all providers that support identify, giving you better visibility into user journeys.

Use @workspace/shared/logger and analytics.identify() in onboarding flows for cleaner logs and more reliable analytics. No configuration required.

Invitation resending is fixed so onboarding flows work more reliably. The default isAnonymous value in seed data has been corrected so new seeds are initialized as intended.

Dependencies have been updated across the platform for stability and security. No action required—these changes are already live.

TurboStarter continues to polish the core so onboarding and setup are more seamless.

Authentication is upgraded to v1.4 with fixes for previous issues and edge cases around login and session management. You should see fewer login hiccups and smoother session behavior.

A new unit test suite covers:

• Shared utilities
• Authentication and billing components
• Coverage reports for critical modules

These changes make the platform more predictable and reliable for everyone.

API security and environment variable handling are improved for safer, more reliable integrations. Marketing copy has been refined for clarity and impact.

AI Kit now supports GPT-5.1 and has been updated to Expo 54, Tailwind CSS v4, and enhanced shadcn/ui components. Mobile improvements include text-to-speech fixes and smoother OTA updates. Placeholder and environment setup are streamlined, plus various UI and workflow fixes across core and AI kit.

These updates keep TurboStarter secure, modern, and easier to work with.

Over-the-air (OTA) updates are now available for mobile. Your TurboStarter mobile app can update its core logic seamlessly so you get the latest features without manual intervention.

We've improved reliability around organization data by fixing invalidation and refresh of the organizations list. You should see accurate, up-to-date information across devices.

Together, these changes keep TurboStarter smoother to use and your workspace current and dependable.