Quick Start

Requirements

• Node.js 22 or newer
• npm 10 or a compatible version
• Git

Install and run

git clone <your-repository-url> ace-admin-max
cd ace-admin-max
npm install
npm run dev

Open http://localhost:5173. The login page contains demo users such as superadmin / 111111.

Commands

Command	Purpose
npm run dev	Copy libarchive assets and start Vite
npm run build	Type-check and build for production
npm run build:only	Build without type checking
npm run typecheck	Run vue-tsc -b
npm run lint	Run ESLint
npm run lint:fix	Fix supported lint issues
npm run format	Format src/ with Prettier
npm run preview	Preview the production build

Demo mode

In development, requests use the current origin and resolve to static files under public/api. Static JSON cannot process parameters or persist writes, so demo CRUD endpoints use GET requests. Replace them with proper GET, POST, PUT/PATCH, and DELETE endpoints when connecting a real backend.

First customization steps

1. Replace product names, logos, system information, and theme defaults.
2. Set production API and base URLs.
3. Remove unused demo pages and the public /test route.
4. Update modules under src/api; do not call Axios directly from pages.
5. Implement backend menus, action permissions, and dictionaries.
6. Run type checking, linting, and a production build before committing.