Is SmartAdmin the Ideal Starting Point for Your Next Project?
This article introduces the open‑source admin platform SmartAdmin, outlines its high‑quality code, security features, technology stack, and provides a step‑by‑step guide to set up the development environment and run the backend and frontend components.
When developing everyday applications, developers often repeat common functionalities such as user management, role management, login, and logging. Fast‑development platforms like RuoYi, JeecgBoot, and Pig are widely used as foundations for new projects. SmartAdmin is another such platform, and as of August 4 2025 it has earned 9.8k stars on Gitee.
SmartAdmin positions itself as a "high‑quality code" platform that is concise, efficient, and secure. It is built on SpringBoot 2/3 + Sa‑Token + Mybatis‑Plus for the backend and Vue 3 + Ant Design Vue 4.x + UniApp for the frontend, offering both JavaScript and TypeScript versions as well as Java 8 and Java 17 builds. The project is released under the MIT license, allowing free commercial use, and claims compliance with Level‑3 network security protection, native encryption, and SQL‑injection defenses.
Technical stack:
Frontend: JavaScript/TypeScript + Vue 3 + Vite 5 + Pinia + Ant Design Vue 4.x
Mobile: UniApp (Vue 3 version) + Uni‑UI (supports APP, mini‑programs, H5)
Backend: Java 8/17 + SpringBoot 2/3 + Sa‑Token + Mybatis‑Plus + multiple databases + p6spy + Redisson, etc.
License: MIT (free, commercial‑friendly)
Main features emphasize "high‑quality code", simplicity, efficiency, and security. Built‑in enterprise‑grade security mechanisms satisfy the "Information Security Technology – Network Security Level Protection – Level 3" requirements, including account lockout after five consecutive failed logins (30 min lock), login timeout recommendations (300‑1800 s), encrypted storage of critical business data, and password complexity rules (minimum 8 characters, at least three character types, no common passwords).
Unique functionalities include:
DataTracer for change‑record tracking, with a Git‑diff‑style preview of before/after data, recording user, IP, device, and changed fields.
Support for request/response encryption using domestic and other algorithms.
Single‑number generator for orders, contracts, etc., with customizable cycles (day, month, year, permanent) and three implementation options: in‑memory lock, Redis lock, or MySQL FOR UPDATE lock.
Environment setup steps:
Prepare prerequisites: Node >= 18 (recommended via nvm), Java 8 or Java 17, MySQL 5.7+, and Redis.
Clone the repository from https://gitee.com/lab1024/smart-admin and import the provided SQL file (≈44 tables) to create the smart_admin_v3 database.
Start a Redis service (e.g., on macOS) and edit sa-base/src/main/resources/dev/sa-base.yaml to replace the JDBC connection string and Redis parameters with your own.
Import the project into an IDE (e.g., IDEA) and run the AdminApplication class in the sa-admin module to launch the backend.
Navigate to the smart-admin-web-javascript directory, execute npm install to install dependencies, then npm run dev to start the frontend development server.
Open http://localhost:8081, log in with the default credentials admin / 123456 , and verify that an incorrect password triggers encrypted transmission as shown in the screenshots.
After the basic introduction and environment installation, the author plans to extend the project with custom login methods such as WeChat scan, Feishu login, SSO, and other bespoke features to deepen understanding and apply the platform in personal or enterprise projects.
Signed-in readers can open the original source through BestHub's protected redirect.
This article has been distilled and summarized from source material, then republished for learning and reference. If you believe it infringes your rights, please contactand we will review it promptly.
Ubiquitous Tech
A ubiquitous public account for pirate enthusiasts, regularly sharing curated experiences, tech learning, and growth insights. Currently publishing articles on AI RAG customer service, AI MCP technology, and open-source design. Personal free Knowledge Planet: Awakening New World Programmer.
How this landed with the community
Was this worth your time?
0 Comments
Thoughtful readers leave field notes, pushback, and hard-won operational detail here.
