Release TSStarter v2.0
Release TSStarter v2.0
Universal Apps architecture with type-safe API gateway, multi-client support, and shared business logic in a Bun monorepo
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-unibranch 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.