🔉 Announcements

• 🚀 MAJOR: Upgraded to Next.js 16! The previous Next.js 14 version is available on the next-14 branch for backwards compatibility.
• ✅ NEW: Type-safe API integration with RBAC system now available! See API Integration Guide below.
• Working on integrating our mock data with actual apis for a more real-world experience. This is the roadmap for implementing our APIs - Admin Hub Apis roadmap

---

• Live preview
• Components preview
• Medium
• Product roadmap * New *

About

A professional admin & dashboard template built using on Mantine 7 that comes with hundreds of UI components, forms, tables, charts, pages and icons. This template is built using Next.js 16, React, Apex Charts,Mantine DataTable and Storybook.

Previous releases

Next.js 14 (App Router)

The previous release with Next.js 14 and Mantine 7 is available for users who need backwards compatibility or prefer the stable version:

• Branch: next-14
• Features: App Router, Mantine 7, React 18, Type-safe API integration, RBAC system

Next.js 13 (Pages Router)

The legacy version supports Next 13 with Pages router and Mantine 6. To view the live demo use this link - preview, and to checkout fork the repo use this link - version 1

Features

• Type-Safe API Integration: Auto-generated TypeScript types from OpenAPI specs with zero boilerplate
• Advanced RBAC System: Role-Based Access Control with permission-aware UI components
• Customizable: You don't need to be an expert to customize the template. Our code is very readable and well-documented.
• Fully Responsive: With mobile, tablet & desktop support it doesn't matter what device you're using. Dashboard is responsive in all browsers.
• Cross-Browser: Our themes are working perfectly with Chrome, Firefox, Opera, and Edge. We're working hard to support them.
• Clean Code: We strictly follow best practices to make your integration as easy as possible. All code is handwritten.
• Regular Updates: From time to time you'll receive an update containing new components, improvements, and bug fixes.

Tech stack

To make this template awesome, I used the following packages:

Core

• Next.js v16: Next.js is an open-source web development framework created by the private company Vercel providing React-based web applications with server-side rendering and static website generation.
• Mantine v7: Mantine is a React UI components library. It's built on top of React and TypeScript, and provides a variety of components and hooks for building high-performance web applications.
• React v18: React is a free and open-source front-end JavaScript library for building user interfaces based on components.
• Typescript v5: TypeScript is a free and open-source high-level programming language developed by Microsoft that adds static typing with optional type annotations to JavaScript.
• Storybook v7: Storybook is a free, open-source tool for developing UI components in isolation. It's used by web developers to improve their UI development workflow and build better web applications.
• Changeset CLI v2: Changeset is a package that helps in managing my versions and changelogs.
• NextAuth v4: NextAuth.js is a flexible and secure authentication library that can be used for client-side authentication in Next.js.
• OpenAPI TypeScript: Auto-generates TypeScript types from OpenAPI specifications for type-safe API integration.
• Tabler icons v2: Tabler Icons is a free, open-source icon library with over 4,700 icons. The icons are designed with a modern aesthetic and are suitable for a wide range of applications.
• Mantine datatable v7: Mantine DataTable is a React component that can be used to create data-rich user interfaces. It is a table component that is aware of dark themes and is designed for Mantine UI.
• Lodash v4: A JavaScript utility library delivering consistency, modularity, performance, & extras.
• Apex chart v3:s ApexCharts is a free, open-source JavaScript charting library that allows developers to create interactive data visualizations for web pages. It can be used for both commercial and non-commercial projects.
• Dayjs v1: Day.js is a JavaScript library that handles dates and times.
• Tiptap v2: A headless, framework-agnostic and extendable rich text editor, based on ProseMirror.
• Fullcalendar v6: FullCalendar is a JavaScript event calendar with over 300 settings. It's open source and has a free core.
• Dnd-Kit v6: Dnd-kit is a lightweight, modular, and extensible drag-and-drop toolkit for React. It is also accessible and performant.
• Embla carousel v7: Embla Carousel is a lightweight carousel library with fluid motion and precise swiping.
• React simple maps v3: An svg map chart component built with and for React.
• Clerk/nextjs v4: Clerk Next.js is a wrapper around Clerk React. It allows users to use the hooks that Clerk React provides.
• React countup v6: A React component wrapper around CountUp.js.

Dev

• Prettier v3: Prettier is a code formatter that automatically formats code to ensure it is consistent and easy to read.
• Husky v8: Husky is a tool that makes it easier to work with git hooks. Prettier is a code formatter.
• Lint staged v15: Lint-staged will automatically add any modifications to the commit as long as there are no errors.
• Postcss v8: PostCSS is a JavaScript library that uses plugins to transform CSS. It transpiles CSS into an abstract syntax tree, which is then represented by JavaScript objects.

Quick start

Download

• Clone this repo git clone https://github.com/design-sparx/mantine-analytics-dashboard.git
• Download from GitHub

Build tools

You'll need to install Node.js. Once Node.js is installed, run npm install to install the rest of the template's dependencies. All dependencies will be downloaded to the node_modules directory.

npm install

Now you're ready to modify the source files and generate new files. To automatically detect file changes and start a local webserver at http://localhost:3000, run the following command.

npm run dev

Compile, optimize, minify and uglify all source files to build/

npm run build

API Integration Setup

Generate type-safe API types from your backend:

# Generate types from development backend
npm run generate:types

File structure

Inside the zip-file you'll find the following directories and files. Both compiled and minified distribution files, as Inside the zip file, you'll find the following directories and files. Both compiled and minified distribution files, as well as the source files are included in the package.

mantine-analytics-dashboard/
├── .changeset
├── .github
├── .gitignore
├── .editorconfig
├── .prettierignore
├── .prettierrc
├── README.md
├── CHANGELOG.md
├── LICENSE
├── index.html
├── package.json
├── tsconfig.json
├── next.config.js
├── postcss.config.cjs
├── clerkMiddleware.ts
├── yarn.lock
├── public/
│   ├── mocks/
│   ├── _redirects
│   ├── favicon.ico
├── src/
│   ├── .changeset/
│   ├── .github/
│   ├── .husty/
│   ├── .storybook/
│   ├── .yarn/
│   ├── app/
├────── api/
├────── error.tsx
├────── error.module.css
├────── global.css
├────── layout.tsx
├────── loading.tsx
├────── not-found.tsx
├────── page.module.css
├────── page.tsx
│   ├── components/
│   ├── hooks/
│   ├── layout/
│   ├── lib/
│   ├────── api.d.ts           # Auto-generated API types
│   ├────── api-client.ts      # Type-safe API client
│   ├────── api/
│   ├──────── hooks/           # API hooks
│   ├──────── permissions/     # RBAC system
│   ├── providers/
│   ├── public/
│   ├── routes/
│   ├── scripts/
│   ├────── generate-api-types.js  # Type generation script
│   ├── styles/
│   ├── theme/
│   ├── types/
│   ├── utils/
│   ├── docs/
│   ├────── API_INTEGRATION.md     # Complete API guide
│   ├────── RBAC_SYSTEM.md         # RBAC documentation
└──

🚀 API Integration & RBAC System

This template now features a comprehensive type-safe API integration system with Role-Based Access Control (RBAC).

⚡ Quick Start

# 1. Generate API types from your backend
npm run generate:types

# 2. Use type-safe hooks in your components
import { useInvoicesWithMutations, PermissionGate } from '@/lib/api';

function MyComponent() {
  const { data, mutations } = useInvoicesWithMutations();

  return (
    <PermissionGate permission="Permissions.Personal.Invoices">
      <InvoiceManager data={data} onCreate={mutations.create} />
    </PermissionGate>
  );
}

🎯 Key Features

• 🤖 Auto-generated TypeScript types from OpenAPI spec
• 🔒 Permission-based access control with React components
• ⚡ Zero-boilerplate API calls with Mantine hooks
• 🔄 Automatic data refreshing after mutations
• 🛡️ Type-safe throughout the entire data flow
• 📱 Mantine-native integration (no extra dependencies)

🏗️ System Overview

lib/api/
├── 🤖 api.d.ts              # Auto-generated OpenAPI types
├── 🔧 api-client.ts         # Mantine useFetch + auth wrapper
├── hooks/                   # Type-safe API hooks
│   ├── auth.ts             # Authentication & profiles
│   ├── projects.ts         # Team collaboration
│   └── invoices.ts         # Personal data
└── permissions/            # RBAC system
    ├── types.ts           # Permission definitions
    ├── hooks.ts           # Permission React hooks
    ├── components.tsx     # Permission UI components
    └── utils.ts           # Permission utilities

🔒 RBAC Overview

Roles

• Admin: Full system access + user management
• User: Team collaboration + personal data access

Permission Categories

• Admin: Permissions.Admin.* - System administration
• Team: Permissions.Team.* - Collaborative resources (shared visibility)
• Personal: Permissions.Personal.* - Private user data (owner-only)
• Users: Permissions.Users.* - User directory access

Usage Examples

// Permission-based UI rendering
<PermissionGate permission="Permissions.Team.Projects">
  <ProjectManager />
</PermissionGate>

// Multiple permission checks
<MultiPermissionGate
  permissions={['Permissions.Team.Projects', 'Permissions.Team.Orders']}
  mode="any"
>
  <TeamDashboard />
</MultiPermissionGate>

// Admin-only content
<AdminOnly>
  <UserManagementPanel />
</AdminOnly>

// Permission hooks
const canCreateInvoices = useHasPermission('Permissions.Personal.Invoices');
const isAdmin = useIsAdmin();

📚 Complete Documentation

• 📖 API Integration Guide - Complete usage guide, adding endpoints, troubleshooting
• 🔐 RBAC System Documentation - Permission system, components, patterns

🚀 Development Workflow

1. Update Backend: Add endpoints to OpenAPI spec with proper tags
2. Generate Types: npm run generate:types
3. Create Hooks: Add API hooks in lib/api/hooks/
4. Add Permissions: Update permission types if needed
5. Use in Components: Import type-safe hooks and permission gates

✨ Benefits

• Developer Experience: Full TypeScript autocomplete and error checking
• Security: Permission checks prevent unauthorized access
• Performance: Built-in caching and automatic data invalidation
• Maintainability: Single source of truth from OpenAPI spec
• Scalability: Automatically grows with your backend API

---

Contributing and Support

I welcome all developers and enthusiasts to contribute to the growth of our open-source admin dashboard template. Contributing is a collaborative process that empowers us to collectively enhance the template’s capabilities and quality. To get started:

• Fork the Repository: Fork the template’s GitHub repository to your own GitHub account.
• Clone the Fork: Clone the forked repository to your local machine using Git.
• Create a Branch: Create a new branch for your contributions to keep the main codebase intact.
• Implement Changes: Make your desired changes, add new components, or refine existing features.
• Commit and Push: Commit your changes to the new branch and push them to your GitHub fork.
• Submit a Pull Request: Submit a pull request from your forked repository to the main template repository. Your changes will be reviewed and potentially merged.

Reporting Issues and Seeking Help

Should you encounter any issues or need assistance while using the template, we’re here to help:

• Issue Tracker: Visit the GitHub repository’s Issues tab to report bugs, suggest enhancements, or seek clarification on aspects of the template.
• Community Interaction: Engage with the template’s community on platforms like GitHub Discussions for assistance, guidance, and insights.

Invitation to Explore and Utilize

The Mantine and Next.js admin dashboard template isn’t just an end; it’s a beginning — a starting point for your creative journey. Whether you’re a seasoned developer seeking a rapid launch or an enthusiast keen on learning modern development practices, this template is your canvas.

Further resources

• Nextjs - https://nextjs.org/docs
• React - https://react.dev/learn
• Mantine - https://mantine.dev/getting-started/
• Nextauth - https://authjs.dev/
• Storybook - https://storybook.js.org/docs/get-started/install
• Apexcharts - https://apexcharts.com/docs/installation/
• Tiptap - https://tiptap.dev/introduction
• Dndkit - https://docs.dndkit.com/
• Embla carousel - https://www.embla-carousel.com/get-started/
• Fullcalendar - https://fullcalendar.io/docs/getting-started
• React simple maps - https://www.react-simple-maps.io/docs/getting-started/