Documentation
Welcome to the official ShadPanel documentation! ShadPanel is a powerful CLI tool that scaffolds complete Next.js admin panels with authentication, form builders, data tables, and 50+ UI components.
What is ShadPanel?
ShadPanel is a comprehensive admin panel generator built on top of Next.js 15 and shadcn/ui. It provides everything you need to build production-ready admin interfaces:
- 🎨 50+ UI Components - Complete shadcn/ui component library
- 📝 Form Builder - Filament-inspired declarative forms with validation
- 📊 Data Tables - Powerful tables with sorting, filtering, and pagination
- 🔐 Authentication - NextAuth.js with Google, GitHub, and credentials
- 🗄️ Database Integration - Prisma ORM with support for PostgreSQL, MySQL, SQLite, MongoDB
- 🎯 TypeScript First - Full type safety and IntelliSense support
- 🌙 Dark Mode - Built-in theme support
- 📱 Responsive - Mobile-friendly sidebar and layouts
- ⚡ Zero Config - Works out of the box
Quick Start
Get your admin panel running in less than 5 minutes:
# Install globally
npm install -g shadpanel
# Create new project
shadpanel init my-admin-panel
# Start development
cd my-admin-panel
npm run devVisit http://localhost:3000 to see your admin panel.
Why ShadPanel?
🚀 Lightning Fast Setup
No more spending days setting up your admin panel infrastructure. ShadPanel generates a complete, production-ready admin panel in seconds:
- Complete Next.js project structure
- Pre-configured authentication system
- Dashboard with sidebar navigation
- Demo pages to get you started
🎨 Beautiful by Default
Built on shadcn/ui, every component is beautifully designed and accessible:
- Modern, clean design
- Consistent design system
- Fully customizable with Tailwind CSS
- Dark mode support
💪 Powerful Features
Everything you need for modern admin panels:
Form Builder:
<Form initialValues={{ email: '', role: 'user' }}>
<FormInput accessor="email" label="Email" required />
<FormSelect accessor="role" label="Role" options={roles} />
<Button type="submit">Save</Button>
</Form>Data Tables:
<Table data={users}>
<TableTextColumn accessor="name" header="Name" sortable searchable />
<TableTextColumn accessor="email" header="Email" searchable />
<TableActionsColumn>
<TableAction icon={Edit} label="Edit" onClick={handleEdit} />
</TableActionsColumn>
</Table>🔧 Flexible & Extensible
Use ShadPanel your way:
- Full Panel - Complete admin panel with everything
- Auth + Components - Authentication system + component library
- Components Only - Just the UI components
- Merge into Existing Apps - Add to your current Next.js project
Core Features
Form Builder
Declarative, type-safe forms with automatic validation:
- 12+ field types (input, select, textarea, date, file upload, etc.)
- Layout components (grid, section, tabs, fieldset)
- Built-in validation with custom rules
- Real-time error feedback
- TypeScript support
Data Tables
Feature-rich tables for managing data:
- Sorting and filtering
- Global search
- Pagination
- Row selection and bulk actions
- Custom cell rendering
- Column visibility controls
Authentication
Complete authentication system with NextAuth.js:
- Multiple auth providers (Google, GitHub, credentials)
- Pre-built login/signup pages
- Session management
- Protected routes
- Type-safe user data
Database Integration
Seamless Prisma integration:
- Support for PostgreSQL, MySQL, SQLite, MongoDB
- Type-safe queries
- Migration management
- Prisma Studio for visual database browsing
- CLI commands for easy database management
UI Components
50+ pre-built components:
Form Elements: Button, Input, Label, Select, Checkbox, Switch, Textarea
Layout: Card, Separator, Tabs, Sheet, Sidebar
Overlays: Dialog, Dropdown Menu, Popover, Tooltip
Feedback: Alert, Badge, Skeleton
Navigation: Breadcrumb
Data Display: Calendar, Table
Installation Types
Full Panel (Default)
Complete admin panel with everything:
shadpanel init my-app --full-panelIncludes: Dashboard, authentication, components, demo pages
Best for: Starting from scratch, complete admin panels
Auth Components
Authentication + component library:
shadpanel init my-app --auth-componentsIncludes: NextAuth.js, login/signup pages, all components
Best for: Adding auth to existing apps, custom dashboards
Components Only
Just the component library:
shadpanel init my-app --components-onlyIncludes: 50+ UI components, form builder, data tables
Best for: Existing Next.js apps, component library only
Documentation Structure
Get Started
- Installation - Install and set up ShadPanel
- Quick Start - Create your first project
- Project Structure - Understand the generated files
CLI Commands
- shadpanel init - Initialize projects
- shadpanel db - Database management
Components
- Overview - Component library introduction
- Form Builder - Build powerful forms
- Data Tables - Create data-rich tables
Features
- Authentication - NextAuth.js integration
- Database Integration - Prisma setup and usage
Guides
- Merging with Existing Projects - Add to existing apps
Community & Support
Resources
Get Help
- Report issues on GitHub Issues
- Ask questions in Discussions
Tech Stack
ShadPanel is built with modern, production-ready technologies:
- Next.js 15 - React framework
- React 18 - UI library
- TypeScript - Type safety
- Tailwind CSS v4 - Styling
- shadcn/ui - Component primitives
- NextAuth.js - Authentication
- Prisma - Database ORM
- Radix UI - Accessible components
License
MIT License - see LICENSE for details
Credits
Built with and inspired by:
Ready to get started? → Quick Start Guide