What problem does it solve?
Provides a structured, maintainable approach for building client UI in Tale using React 19, TanStack Router, and Convex as the live data source, covering route-scoped vs shared code, gating, prefetch, and consistent styling with ui-components.
Core Features & Use Cases
- Pattern-guided UI development: codifies where to place components, hooks, and routes under services/platform/app/** and packages/ui/** to keep dependencies clean and predictable.
- Routing and data-fetching discipline: advocates using TanStack Router for in-app navigation and gating data access through Convex queries/mutations with proper loading, prefetch, and error handling.
- Loading, i18n, and styling conventions: prescribes skeleton-based loading, use of i18n client utilities, and styling patterns (CVA / cn and Tailwind) across components to ensure consistency.
- Best practices for reuse and maintenance: defines when to lift code to top-level shared paths and how to structure for testability and future evolution.
Quick Start
Start by identifying a new UI feature under services/platform/app or packages/ui, then implement it using the container/presentational pattern and gated Convex data fetching for loading and updates.