Skip to content

origadmin/shadcn-admin-design

Repository files navigation

OrigAdmin Panel

Preview

signin signup dashboard

Tech stack

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.

Instructions for getting started with the basics

How it works

  1. Make sure it's installed on your machine: Bun

  2. Clone the project to the local computer:

    git clone https://github.com/origadmin/shadcn-admin-design
  3. Go to the project directory:

    cd shadcn-admin-design
  4. Install dependencies:

    bun install
  5. Start the project:

    bun dev
  6. Open the browser and visit http://localhost:3000 to see the project.

  7. Demo

  • default user account: admin and password: adminadmin (you can change it in the src/pages/auth/index.tsx file).
  • captcha is not validated in the demo, so you can log in directly with four digits.

Script used

    "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

Project features:

  • 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.

Project Description

  • 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.

License

This project is licensed under MIT License. Feel free to use and modify it, but please keep the original author information.