Introduction

Welcome to rts-common, a comprehensive shared component library designed for building modern micro-frontend applications. This library provides everything you need to create consistent, accessible, and beautiful user interfaces across your application ecosystem.

What is rts-common?

rts-common is a production-ready component library that combines:

• UI Components: Built on top of shadcn/ui and Radix UI primitives
• Layout System: Flexible sidebar and navigation components
• Authentication: Integrated OIDC authentication via react-oidc-context
• Theme Management: Sophisticated theming with dark mode support
• Utilities & Hooks: Common patterns and helpers for React applications
• Type Safety: Full TypeScript support with comprehensive type definitions

Key Features

🎨 Beautiful & Accessible Components

All components are built with accessibility in mind, following WAI-ARIA guidelines and best practices. They're styled with Tailwind CSS and fully customizable to match your brand.

🔐 Security First

Built-in authentication support with OIDC makes it easy to secure your applications. The library handles token management, refresh, and protected routes out of the box.

🎯 Micro-Frontend Architecture

Designed specifically for micro-frontend applications where multiple teams need to share UI components and maintain consistency across different applications.

🌓 Powerful Theming

Sophisticated theme system with:

• Dark mode support
• Multiple theme presets
• CSS variables for easy customization
• Per-component style overrides

⚡ Developer Experience

• TypeScript-first approach
• Excellent IDE support with IntelliSense
• Comprehensive documentation
• Minimal configuration required

Who Should Use This?

rts-common is ideal for:

• Enterprise Teams: Building multiple applications that need to share components
• Micro-Frontend Projects: Teams working on distributed applications
• Design Systems: Organizations establishing a consistent design language
• Rapid Prototyping: Developers who want to build quickly with production-ready components

Technology Stack

Built with modern, battle-tested technologies:

• React 19: Latest React features and performance improvements
• TypeScript: Type-safe development experience
• Tailwind CSS: Utility-first styling
• Radix UI: Accessible component primitives
• TanStack Router: Type-safe routing
• Framer Motion: Smooth animations
• react-oidc-context: OIDC authentication

Browser Support

rts-common supports all modern browsers:

• Chrome (latest)
• Firefox (latest)
• Safari (latest)
• Edge (latest)

License

rts-common is released under the MIT License.

Getting Started

Ready to dive in? Check out the Quick Start Guide to begin using rts-common in your project.