Quick Start

Generate a project

Run this in the scaffold directory:
终端窗口
```
npm run dev
```
Follow the prompts to choose the frontend framework and backend framework, then enter a project name (only lowercase letters, digits, and hyphens are allowed; the default is my-fullstack-app).
```
? Select a frontend framework: React / Vue
? Select a backend framework: Python (FastAPI) / Java (Spring Boot)
? Enter a project name: my-project
```
The generated project appears in the current directory, with git init and an initial commit performed automatically.
Start the development environment
终端窗口
```
cd my-project
./dev.sh start
```
dev.sh first installs the frontend and backend dependencies, then starts both services and automatically opens the logs:
```
Frontend:  http://localhost:5173
Backend API:  http://localhost:8088
API Docs:  http://localhost:8088/docs
```
Log in to the system

Open http://localhost:5173 and log in with the default administrator account:

Username Password Role

admin 123456 Administrator

The default password 123456 is for development and debugging only. After deploying to production, log in immediately and change the administrator password.

Default Accounts

In addition to the administrator, the template includes four regular users, all with the password 123456:

Username	Name	Role
`admin`	Administrator	`admin` (all permissions)
`zhangsan`	Zhang San	`user`
`lisi`	Li Si	`user`
`wangwu`	Wang Wu	`user`
`zhaoliu`	Zhao Liu	`user`

See Default Accounts.

Ports

Environment	Frontend	Backend
Development	5173	8088
Docker	5173	8088 (inside the container, behind the Nginx reverse proxy)

Next Steps

Project Structure — what is in the generated directories.
Authentication and Accounts — login, registration, maintenance mode, and manual review.
Docker Deployment — package it as a single image and go live.