shadcn-ui/taxonomy
Taxonomy
Taxonomy is a full-stack application template and reference implementation built with the Next.js app router. It serves as a comprehensive starter for developing web applications using server components and modern React patterns.
The project integrates a variety of specialized systems, including an identity management workflow for OAuth and session handling, and a billing system for managing recurring subscriptions and payment events. It also features a content pipeline that transforms Markdown and JSX files into type-safe data collections for rendering blogs and documentation.
The architecture includes a type-safe database access layer for relational data, runtime schema validation for API payloads and forms, and a themed user interface built from accessible, headless primitives.
This repository provides a complete implementation of these features, including the integration of specific tools for database management, authentication, and content processing.
Features
- Next.js Development - Serves as a full-stack application starter utilizing Next.js server components and the app router.
- Server Components - Implements a modern web architecture centered around Next.js server components for optimized rendering.
- Zod Runtime Validation - Uses Zod schemas to provide type-safe runtime validation for form and API data.
- Relational Persistence Layers - Implements a persistence layer using a relational database and ORM for structured application state.
- Database ORMs - Uses Prisma ORM to map database records to application objects and manage relational schemas.
- Type-Safe Database Clients - Provides a type-safe database client via Prisma for compile-time query validation.
- Database Schema - Uses a schema-driven approach to generate type-safe database clients for compile-time query validation.
- JWT Session Management - Manages user authentication and persistent sessions using JSON Web Tokens (JWT).
- Runtime Data Validation - Employs runtime schema validation for API payloads and form inputs to ensure data integrity.
- User Authentication Flows - Implements secure sign-in and session management using NextAuth.js to protect private routes.
- Accessible UI Components - Develops accessible user interfaces with keyboard navigation and screen reader support using Radix UI.
- Headless Primitives - Builds the user interface using headless primitives that provide accessibility and logic without visual styling.
- Form Input Validation - Implements runtime validation for user forms and API inputs to ensure data correctness.
- Billing and Subscription Management - Provides a system for managing commercial subscription plans and recurring billing cycles.
- Stripe Billing Integrations - Connects the application to Stripe to process recurring billing events and subscription updates.
- MDX Content Management - Creates type-safe blogs and documentation sites by transforming MDX files into web pages.
- MDX Processors - Transforms MDX files with embedded JSX into type-safe data collections using Contentlayer.
- State Synchronization Webhooks - Synchronizes local database subscription states with external payment events via webhooks.
- Build-Time Asset Processing - Implements a build-time pipeline that transforms MDX files into type-safe content collections.
- OAuth and Identity Providers - Integrates OAuth providers and session handling through NextAuth.js for secure user identity management.
- Accessible UI Frameworks - Builds a composable user interface adhering to accessibility standards using headless primitives.
- Design Systems - Ships a themed user interface design system built from accessible Radix UI primitives.
- Interface Theming Systems - Implements a themed interface system including a toggleable dark mode for responsive user interfaces.
- MDX Rendering Frameworks - Renders interactive documentation and blog posts by mixing markdown with JSX components.
- Route Grouping - Utilizes Next.js route grouping to organize application routes and layouts without affecting the URL path.
