mrkeyoor.com_
Tue 29 Sept 21:19 UTC
Webevaluationupdated 28 Sept 2026

shadcn-admin review

Shadcn Admin is a responsive React dashboard UI built with Vite, shadcn/ui, Tailwind CSS, and TanStack Router. The author explicitly says it is not a starter template, so treat it as a worked screen collection to copy and adapt, not an admin product with your data and permissions already wired.

trackingstars / 7d
Verdict

Our shadcn-admin install stopped after 11 seconds because pnpm blocked build scripts for Clerk and two esbuild versions, so we never reached its build or tests. Use it as a screen and layout reference if you already know how to assemble a React admin app and can review dependency scripts. Skip it when you need a supported starter with data access, roles, authentication, and an unattended install path already settled.

We ran it

Lab card: what happened when we ran shadcn-adminScreenshot of shadcn-admin (shadcn-admin.netlify.app)
Install✗ · 11s
Build—
Repo272 files~19,334 lines of source · 2.1 MB · 2 CI workflows

Answers from our run

Does shadcn-admin build from source?

The dependency install failed, and the project has no separate build step. We cloned commit e16c87f into a clean Debian container with 3 CPUs and no project-specific setup.

Who should not use shadcn-admin?

Teams looking for a drop-in starter: the README says this is not a starter project, and authentication is described as partial.

What are the alternatives to shadcn-admin?

React Admin, Refine, Ant Design Pro. Our shadcn-admin install stopped after 11 seconds because pnpm blocked build scripts for Clerk and two esbuild versions, so we never reached its build or tests.

Setup2/5Install stopped on 3 blocked dependency build scripts
Docs3/5Stack and component forks are clear; integration guidance is thin
Community5/514,973 stars with September 2026 code and pull request activity
Maturity3/5v2.2.1 is established, but it is explicitly not a starter

Who it’s for

React teams that want finished dashboard screens as a visual and structural reference.
Developers already comfortable with shadcn/ui, Tailwind CSS, TanStack Router, and manual component merges.
Products that need right-to-left layout work across dialogs, tables, menus, and the sidebar.
Designers and engineers who want a live set of desktop and mobile admin patterns before building their own data layer.

Who it’s NOT for

Teams looking for a drop-in starter: the README says this is not a starter project, and authentication is described as partial.
Locked-down build systems that cannot approve dependency scripts: our install stopped because pnpm blocked scripts for Clerk and esbuild packages.
Users who expect shadcn CLI updates to be automatic: 13 listed UI components have local or RTL changes that may need manual merging.
Products that need roles and permissions out of the box: issue 248 requests a sub-admin role and permission page.
Dense settings products unwilling to repair layout edge cases: issue 261 reports nested scrollbars and blank space when a form grows tall.

Setup reality

Our sandbox install failed with exit code 1 after 11 seconds. Pnpm verified the lockfile, then stopped with ERR_PNPM_IGNORED_BUILDS because scripts for @clerk/shared@4.8.6, esbuild@0.25.11, and esbuild@0.27.1 were ignored. We did not reach a build or test run.

Local use needs Node, pnpm, and a decision about those blocked scripts. The UI stack is client-side React; real APIs, authorization, persistence, and most product behavior remain your work. Clerk integration is partial and needs its own project configuration for live authentication.

The measured checkout had 2 CI workflow files, no Dockerfile, and no tests directory. Thirteen shadcn components are locally changed for general or RTL behavior, so future CLI updates may require a manual merge rather than a clean overwrite.

The README says this is not a starter project

Shadcn Admin looks like the beginning of a product: sidebar, search command, dashboard, settings, tables, sign-in screens, light and dark themes, and more than 10 pages. The author draws a firmer boundary. This is a reusable collection of dashboard UI, with authentication described as partial, not a starter template. That distinction should decide whether you clone it. It gives you working composition and styling, while APIs, real records, permissions, persistence, and deployment remain application work.

The codebase is compact enough to study. Our checkout held 272 files, about 19,334 lines of source, and occupied 2.1 MB. React 19, TypeScript, Vite, Tailwind CSS, Radix primitives, TanStack Router, TanStack Query, TanStack Table, React Hook Form, Zod, and Zustand form the current stack. That is a familiar set for a modern front end, but it is also a stack you will own after copying the screens into your product.

RTL work covers 10 components that shadcn does not hand you

Right-to-left support is the most concrete reason to borrow from this repository instead of assembling the same dashboard from stock examples. The README names 10 components with RTL changes: alert dialog, calendar, command, dialog, dropdown menu, select, table, sheet, sidebar, and switch. It also lists scroll area, Sonner, and separator as generally modified. Layout direction, menu placement, table behavior, and overlays have already been considered together.

Those 13 local components create maintenance work. The shadcn CLI can update ordinary components safely, according to the README, but locally changed files may need a manual merge to retain the RTL or other edits. A team that routinely pulls upstream component updates should put these files under deliberate review. The value here is source you can own, and the cost is source you must keep reconciled with upstream changes.

What happened when we ran it

Our sandbox tried to install commit e16c87f with pnpm under Node 22. The install stopped with exit code 1 after 11 seconds. The lockfile passed the environment's supply-chain policy, but pnpm refused to continue because build scripts were ignored for @clerk/shared@4.8.6, esbuild@0.25.11, and esbuild@0.27.1. Its own message recommended running pnpm approve-builds to choose which dependencies may execute scripts.

We did not approve those scripts because that changes the security decision the install was testing. No build ran, and no test command ran. There are no honest compiler or test results to report for this commit. The checkout had 2 CI workflow files, no Dockerfile, and no tests directory. The current package file defines browser tests through Vitest and Playwright, but our measured install never reached them.

The failure does not prove the application code is broken. It proves a clean install under a policy that blocks undeclared dependency scripts needs an explicit approval step. Esbuild commonly needs an install script to place its platform binary, while Clerk's package was named separately by pnpm. Review the scripts, approve only what your policy permits, and pin that decision in the environment that will build the app.

Partial Clerk pages do not supply product authorization

The dependency list includes Clerk's React package, and the repository has Clerk sign-in, sign-up, and user-management pages. The README still labels auth as partial. Open issue 248 requests a role and permission page for sub-admins, which is a useful statement of what the demo does not provide. A production admin needs authorization on every server action and data query; hiding a navigation item in React is not that control.

Visual edge cases are still being found too. Issue 309 reports that system theme mode leaves the browser theme-color meta tag on the light value even when the operating system is dark. Issue 302 shows misaligned theme and settings buttons on Clerk pages. Issue 261 reports a second scrollbar and blank space when settings content grows very tall. None is a reason to reject the repository, but each is a reason to test your own routes and data lengths rather than accepting the demo screenshots as coverage.

The screen kit is better for copying than for forking whole

A useful adoption path is to pick one vertical slice: the shell, sidebar, command search, table, or settings layout. Move it into an application where routing, API access, auth, error handling, and tests already have owners. That keeps the visual work while avoiding a long-lived fork of every dependency and sample page. The MIT license permits that use, and source ownership fits the way shadcn components are meant to be adapted.

Forking the entire project makes more sense only when its stack already matches yours. Version 2.2.1 was released on November 6, 2025, while GitHub recorded the last push on September 10, 2026. The repository had 14,973 stars and 24 combined issues and pull requests when fetched. Recent dependency pull requests show continued upkeep even though the release tag is older, so health is better judged from both signals.

React Admin or Refine is the better choice when data providers, forms, access control, and resource conventions are the hard part. Ant Design Pro offers a fuller scaffold if its design system fits. Shadcn Admin wins when you want readable source, shadcn styling, and RTL-aware dashboard composition, then plan to build the application layer yourself. Our failed 11-second install means that work begins with a dependency-script review, not pnpm run dev.

Alternatives

ProjectWhat it isPick it when
React Admin gh↗A data-driven React framework for building real admin and internal applications.pick this instead when CRUD behavior, data providers, authorization, and forms matter more than owning every visual detail.
RefineA React framework for internal tools with routing, auth, data-provider, and UI integrations.pick this instead when you need application plumbing as well as dashboard components.
Ant Design ProAn opinionated admin application scaffold built around Ant Design.pick this instead when a fuller application scaffold is worth accepting Ant Design's visual system.

What people are saying

  1. [github-trending] satnaing/shadcn-admin

Sources

  1. Shadcn Admin README
  2. Shadcn Admin repository
  3. Shadcn Admin v2.2.1
  4. Issue 248: sub-admin roles and permissions
  5. Issue 261: nested settings scrollbars
  6. Issue 309: system theme color mismatch

More web reviews

vinext · robinhood-meme-token-stock-launchpad · kool-brushez · pure · m3e-canvas · fable51-worlds · the whole board →