Release TSStarter v2.0

Article
Featured

Release TSStarter v2.0

Universal Apps architecture with type-safe API gateway, multi-client support, and shared business logic in a Bun monorepo

TSStarter Team
Author
12/11/2025
Published

Developers, get ready to level up your TypeScript projects! TSStarter v2.0 brings a reimagined architecture with best-in-class TypeScript tools in a Bun monorepo, complete with a web app, type-safe API gateway, and multi-client support. This isn’t just an update — it’s a foundation that empowers you to ship faster, scale smarter, and build with confidence.

Introducing Universal Apps Architecture

TSStarter v2.0 introduces a Universal Apps architecture, powerful and production-ready, designed to work seamlessly across web, mobile, and desktop platforms. This new architecture fully leverages the Bun runtime to deploy both web and API gateway services within a unified monorepo, enabling support for multiple client types while maintaining a single source of truth for your business logic.

I feel very happy with this new architecture — leveraging Bun, a unified monorepo, and multi-client support makes it a joy to build with. I feel confident that I can create many applications on top of this foundation, and I truly believe we can stick with this architecture for a long time.

Optimized Web Application

The web application is built with TanStack Start and React 19, featuring Server-Side Rendering (SSR) and real-time updates. It leverages internal RPC on the server for fast communication without HTTP overhead, and client-side RPC over /api/rpc/$ routes. This architecture ensures high performance and a smooth developer experience while maintaining type safety throughout the stack.

API Gateway with Multi-Client Support

The API Gateway is powered by Bun + ElysiaJS, providing high-performance, type-safe REST endpoints for external clients. By sharing business logic between the web app and API gateway, we ensure consistency and reliability across all client types. The gateway automatically generates OpenAPI documentation with a beautiful Scalar UI interface at /api/docs, making API integrations easier than ever.

Shared Routers & Code Reuse

All business logic resides in oRPC shared routers under services/shared/routers/. This framework-agnostic approach provides:

  • End-to-end TypeScript type safety across all clients
  • Single source of truth for web and API implementations
  • Reusability across platforms (web, mobile, desktop) without code duplication

Developer Benefits

  • Type-safe clients auto-generated for TypeScript
  • Hot reload for rapid development across all services
  • OpenAPI documentation with Scalar UI at /api/docs
  • Comprehensive documentation with setup guides for Universal Apps architecture
  • Bun monorepo for fast package management and unified development workflow

What's New in v2.0

This release includes significant improvements to both the architecture and documentation:

  • Universal Apps Architecture: New tsstarter-uni branch with separate Web App (TanStack Start) and API Gateway (Bun + ElysiaJS)
  • API Gateway: REST API endpoints with OpenAPI documentation and Scalar UI at /api/docs
  • oRPC Shared Routers: Framework-agnostic business logic in services/shared/routers/ for code reuse across platforms
  • Universal Apps Documentation: Complete introduction and setup guides for the new architecture
  • Homepage Updates: Refreshed hero text and improved tech stack presentation
  • Docs Homepage: Enhanced documentation with improved card animations and user experience

Getting Started

Ready to explore the new architecture? Check out the Universal Apps Introduction and Setup Guide to get started with TSStarter v2.0.

The tsstarter-uni branch contains the complete Universal Apps implementation, while the main branch continues to support the traditional web-only architecture.

Experience the power of TSStarter v2.0 today! Clone the tsstarter-uni branch, explore the Universal Apps architecture, and start building scalable, type-safe applications faster than ever.