AppShell is an opinionated React application framework for creating applications on Tailor Platform. It gives you authentication, routing, sidebar navigation, responsive layouts, and reusable ERP components out of the box — so you can focus on building business screens.
| Package | Version | Description |
|---|---|---|
@tailor-platform/app-shell |
 |
Core library — components, hooks, layouts, and authentication |
@tailor-platform/vite-plugin-app-shell |
 |
Vite plugin for file-based routing |
@tailor-platform/sdk-plugin-app-shell |
 |
SDK plugin that generates AppShell metadata |
@tailor-platform/eslint-plugin-app-shell |
 |
ESLint v9 and Oxlint rules for AppShell applications |
| Example | Description |
|---|---|
vite-app |
Vite app with file-based routing plus the consolidated UI showcase |
Next.js App Router compatibility is covered by the minimal smoke fixture under e2e/tests/nextjs-smoke.
For users building applications with AppShell, see the detailed guides in docs/:
- Introduction — What is AppShell and why use it
- Quick Start — Installation, setup, and first steps
- Migrations — Breaking changes and the steps each one requires, newest first
Hosted references, no checkout required:
| Site | Description |
|---|---|
| UI Catalogue | Live component previews, full-page samples, composite UI patterns, and routing recipes |
| Theme Generator | Generate an AppShell palette CSS file from a primary color |
This project is a monorepo managed with pnpm + turbo. For prerequisites, setup, the end-to-end development workflow, and publishing, see CONTRIBUTING.md.