shaadkit,
my production-oriented stack for Nextjs projects
Not just a boilerplate
Ordinary boilerplates are just a starting point. ShaadKit is a complete, opinionated foundation that solves every concern of a professional project from day one.
Bun as Package Manager
A fast and modern package manager that keeps dependency installation, scripts, and project tooling simple and efficient.
Mantine v9
A powerful and accessible component library with flexible theming, composable primitives, and everything needed to build polished interfaces.
next-intl
Production-ready internationalization with structured translations, locale management, and a scalable foundation for multilingual applications.
TanStack Query
A robust server-state solution for caching, synchronization, mutations, background updates, and managing asynchronous application data.
Storybook 10
Develop, document, test, and refine UI components in isolation with a dedicated environment built for component-driven development.
Vitest + Playwright
A complete testing foundation combining fast unit and integration tests with reliable end-to-end testing for critical user flows.
Stylelint + ESLint
Consistent and maintainable code through automated linting, modern conventions, and opinionated rules that keep the codebase clean.
Bundle Analyzer
Visualize your production bundle, identify unnecessary dependencies, and discover practical opportunities to improve application performance.
React 19 + Compiler
Built on modern React with compiler-powered optimizations designed to reduce manual performance work and keep components efficient.
Arktype & Arkenv
Type-safe runtime validation and environment configuration that help catch invalid data and configuration issues before they reach production.
Production Ready
A carefully curated development foundation with essential tooling and conventions already configured for building maintainable applications.
Zero Configuration
Everything is preconfigured to work together from the first command, eliminating repetitive setup so you can focus on building your product.
It's ready in under 5 minutes!
Get ShaadKit up and running with just a few commands. No complex configuration, no extra dependencies — just a production-oriented stack.
📋 Prerequisites
Before you begin, make sure the following tools are installed on your system:
🚀 Setup Steps
1. Clone the template
Clone the ShaadKit template from GitHub:
Git
git clone https://github.com/shaadcode/shaadkit.git my-app
2. Install dependencies
Navigate into the project folder and install dependencies:
Bun
cd my-app && bun install
3. Start the dev server
Launch the Next.js development server:
Bun
bun dev
You can now view your project at http://localhost:3000.
4. Done! 🎉
Your project is ready. You can now explore components in Storybook, run tests, or start coding right away.
Frequently Asked Questions
Everything you need to know about ShaadKit. Can't find what you're looking for? Open an issue on GitHub
About ShaadKit
Installation & Setup
Customization
Features & Capabilities
Still have questions? Open an issue on GitHub
Tools that might come in handy
If you find ShaadKit useful, you might also enjoy these projects built with the same philosophy — lightweight, focused, and ready to use.
ICU-studio
Fast and lightweight IDE for ICU messages
A fast, lightweight IDE for working with ICU messages. Built with TypeScript and designed to make message formatting easier.
Transform.tools
Convert anything to anything
A multi-purpose converter for code formats — HTML to JSX, JSON to TypeScript, SVG to JSX, and dozens more. Essential for any developer working across multiple languages.
Mantine Colors Generator
Generate perfect color palettes
Official Mantine tool for generating 10-shade color palettes that work seamlessly with the Mantine theme. Paste a color, get a full palette ready for your theme object.
i18n Ally Next
i18n on steroids
A powerful internationalization companion for Next.js. Inline translations, auto-completion, and a visual editor for your locale files — makes next-intl feel like a breeze.
Built by the community, for the community
ShaadKit is open source and welcomes contributions of all kinds — not just code. Whether you report a bug, improve docs, or just star the repo, you are part of the project.
Report Bugs
Found something broken? Open an issue with clear steps to reproduce. Every bug report helps make ShaadKit more stable.
Suggest Features
Have an idea that would make ShaadKit better? Share it in GitHub Discussions. We love hearing from the community.
Submit Pull Requests
Fix a bug, improve documentation, or add a new feature. Check out the "good first issue" label for a great starting point.
Improve Docs
Documentation is just as important as code. Help us make ShaadKit docs clearer, more complete, and easier to follow.
Star the Repo
A simple star on GitHub helps others discover ShaadKit. It takes a second and means a lot to the project.
Join the Discussion
Answer questions, share your experience, or just say hi. The community is what makes open source great.
Ready to make your first contribution?
The process is straightforward. Here is how to get started:
- Discuss first — open an issue or start a discussion to share your idea and get feedback before writing code
- Fork the repository on GitHub
- Clone your fork locally and create a new branch
- Make your changes following the project's code style
- Test your changes with bun run test
- Submit a Pull Request with a clear description and reference the original issue
New to open source? Look for issues labeled
Have questions? Open a GitHub Discussion and we will help you out.
