https://github.com/tailor-platform/app-shell
Opinionated React application framework for creating applications on Tailor Platform.
https://github.com/tailor-platform/app-shell
framework react
Last synced: 17 days ago
JSON representation
Opinionated React application framework for creating applications on Tailor Platform.
- Host: GitHub
- URL: https://github.com/tailor-platform/app-shell
- Owner: tailor-platform
- License: mit
- Created: 2026-02-16T03:12:00.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-04-24T07:04:13.000Z (20 days ago)
- Last Synced: 2026-04-24T07:29:27.437Z (20 days ago)
- Topics: framework, react
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/@tailor-platform/app-shell
- Size: 1.4 MB
- Stars: 4
- Watchers: 0
- Forks: 1
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Tailor Platform App Shell
[](./LICENSE.md)
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.
## Packages
| Package | Version | Description |
| ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
| [`@tailor-platform/app-shell`](./packages/core) | [](https://www.npmjs.com/package/@tailor-platform/app-shell) | Core library — components, hooks, layouts, and authentication |
| [`@tailor-platform/app-shell-vite-plugin`](./packages/vite-plugin) | [](https://www.npmjs.com/package/@tailor-platform/app-shell-vite-plugin) | Vite plugin for file-based routing |
## Examples
| Example | Description |
| ------------------------------------- | ------------------------------------------------------ |
| [`vite-app`](./examples/vite-app) | Vite app with file-based routing using the vite-plugin |
| [`nextjs-app`](./examples/nextjs-app) | Next.js App Router integration |
## Documentation
For users building applications with AppShell, see the detailed guides in `docs/`:
- [Introduction](./docs/introduction.md) — What is AppShell and why use it
- [Quick Start](./docs/quickstart.md) — Installation, setup, and first steps
## Development
This project is a monorepo managed with pnpm.
### Setup
```bash
pnpm install
```
### Commands
```bash
pnpm dev # Start all packages in development mode with hot reloading
pnpm build # Build all packages for production
pnpm type-check # Run type checking across all packages
```
### Testing
```bash
cd packages/core && pnpm test
```
### Publishing
This project uses [changesets](https://github.com/changesets/changesets) for version management:
```bash
pnpm changeset:create # Create a changeset describing your changes
pnpm changeset:publish # Build and publish to NPM (automated via CI)
```