This project implements the front-end Admin design based on the following technologies:
- ShadcnUI: A React UI component library that provides a set of accessible and customizable components.
- RSBuild: A modern build tool that simplifies the process of building web applications.
- Tailwind: A utility-first CSS framework for rapidly building custom designs.
- Postcss: A tool for transforming CSS with JavaScript, enabling the use of plugins to extend CSS functionality.
- Prettier: A code formatter that enforces consistent style by parsing your code and re-printing it with its own rules.
- Bun: A fast all-in-one JavaScript runtime, bundler, and package manager.
- TypeScript: A statically typed programming language that builds on JavaScript, adding features like interfaces and generics.
- ESLint: A tool for identifying and reporting on patterns found in ECMAScript/JavaScript code, with the goal of making code more consistent and avoiding errors.
-
Make sure it's installed on your machine: Bun。
-
Clone the project to the local computer:
git clone https://github.com/origadmin/shadcn-admin-design
-
Go to the project directory:
cd shadcn-admin-design
-
Install dependencies:
bun install
-
Start the project:
bun dev
-
Open the browser and visit http://localhost:3000 to see the project.
- default user account:
admin
and password:adminadmin
(you can change it in thesrc/pages/auth/index.tsx
file). - captcha is not validated in the demo, so you can log in directly with four digits.
"start": "bun run dev",
"dev": "bun tailwind:dev && rsbuild dev --open",
"dev:web": "bun tailwind:min && rsbuild dev --open",
"build": "bun tailwind && rsbuild build",
"preview": "bun tailwind:min && rsbuild build && rsbuild preview",
"rsbuild": "bun run build",
"tailwind": "bun tailwind:min",
"tailwind:dev": "bunx tailwindcss --postcss -i ./src/styles/globals.css -o public/index.css",
"tailwind:min": "bunx tailwindcss --postcss -i ./src/styles/globals.css -o public/index.css --minify",
"shadcn": "bun x --bun shadcn@latest",
"style:all": "bun lint && bun stylelint && bun format",
"format": "prettier --write .",
"format:check": "prettier -c -w .",
"lint": "eslint .",
"lint:fix": "eslint ./src --fix && bun format",
"lint:strict": "eslint --max-warnings=0 ./src",
"style": "stylelint ./src/**/*.{css}"
- Build the project
bun run build
# or
bun rsbuild
- Add ShadcnUI Component
bun shadcn add xxx
- Format the file
bun format
- Lint the file
bun lint
- Fast Load: Currently, the main page loads in less than 300ms, ensuring very strong performance.
- High Performance: Use Bun as a build tool to provide a fast build and hot reload experience.
- Responsive Design: Based on Tailwind CSS, it ensures a good user experience on a wide range of devices.
- Scalability: The project is clearly structured and easy to scale and maintain.
- Modern Development: Use TypeScript and ESLint to improve code quality and development efficiency.
- This project does not use Node-based backend technologies such as Next.js, Express, Nest.js and so on.
- This project does not use other build tools such as Vite.
- This project is intended to be used with the OriginAdmin backend.
- This project is designed to be used as a template for other projects.
This project is licensed under MIT License. Feel free to use and modify it, but please keep the original author information.