simple-template

Simple Template

Quick Start

This project contains:

• backend: Spring Boot admin API.
• frontend/web: Vite + Vue 3 admin frontend.
• frontend/app: Taro + Vue 3 app frontend.

The local development flow starts MySQL and Redis with Docker, then runs the backend and web frontend locally.

Requirements

• JDK 8+
• Docker Desktop or Docker Engine with Compose
• Node.js
• pnpm

Start Infrastructure

The development backend is configured to use the same defaults as backend/docker-compose.yml:

• MySQL: localhost:3306, user root, password root123
• Redis: localhost:6379, password redis123
• Database name: agileboot_pure

You can start MySQL and Redis manually:

cd backend
docker compose up -d

On a fresh Docker volume, Compose creates the MySQL database agileboot_pure. Import the SQL files under backend/sql/ before starting the backend.

Install Frontend Dependencies

cd frontend
pnpm install

Start Backend and Web Frontend

Start the backend:

cd backend
./mvnw -pl agileboot-admin -am spring-boot:run

Start the web frontend:

cd frontend
pnpm dev:web

• Backend: http://localhost:8080
• Frontend: Vite output, usually http://localhost:80/

The frontend development proxy maps /dev-api to http://localhost:8080.

Optional app commands:

cd frontend
pnpm dev:app:weapp
pnpm dev:app:h5

Git Hooks

This repository uses .githooks as the single Git hooks entrypoint.

git config core.hooksPath .githooks

The frontend workspace uses pnpm:

cd frontend
pnpm install
pnpm dev:web
pnpm build:web
pnpm dev:app:weapp
pnpm build:app:weapp
pnpm lint
pnpm typecheck

Frontend

frontend is a pnpm workspace:

• web: Vite + Vue 3 admin frontend.
• app: Taro + Vue 3 app frontend.

Shared engineering configuration lives in frontend root. Subprojects should extend the shared TypeScript, ESLint, Stylelint, Prettier, commitlint, and lint-staged configuration instead of duplicating it.