Introduction

AppShell gives you everything you need to build production-ready ERP applications on Tailor Platform with minimal configuration.

What is AppShell?

AppShell is a React-based framework that provides the foundation for building custom ERP applications on Tailor Platform. It handles the complex infrastructure so you can focus on building business-level screens and features.

Out of the Box

When you integrate AppShell into your React application, you get:

• ✅ Simple composition - Compose custom Tailor-powered, React-based ERP applications with minimal code
• ✅ User authentication - Complete OAuth2 flow with token management and session persistence
• ✅ Authorization - Route guards for permission-based and role-based access control
• ✅ File-based routing - Define pages through directory structure with auto-generated navigation
• ✅ Beautiful layouts - Responsive, opinionated layouts with sidebar navigation and breadcrumbs
• ✅ Convenience hooks - Access application, module, and user contexts with React hooks

Key Features

🚀 File-based Routing

Define pages through directory structure with automatic sidebar navigation and breadcrumbs. No manual route configuration needed.

→ Learn about File-Based Routing

🔒 Built-in Authentication

OAuth2/OIDC integration with Tailor Platform's Auth service. Supports any configured IdP including Google, Okta, and Auth0.

→ Authentication Guide

🎨 Beautiful UI Components

Responsive layouts, description cards, command palette, and more. Built with Tailwind CSS v4 and shadcn/ui principles.

→ Quick Start