1. Project Overview

vue-fastapi-admin

A modern frontend-backend separated development platform built with FastAPI + Vue 3 + Naive UI. It integrates RBAC permission management, dynamic routing, and JWT authentication to help small and medium-sized applications get up and running quickly. It can also be used as a learning reference.

2. Open Source License

Licensed under MIT

3. Screenshots

Login Page

Workspace

User Management

Role Management

Menu Management

API Management

4. Feature Overview

Features

• Popular Technology Stack: Built with Python 3.11 and the high-performance FastAPI asynchronous framework, combined with cutting-edge technologies such as Vue 3 and Vite, and using pnpm, an efficient npm package manager.

• Code Standards: The project includes a rich collection of code quality and standards plugins to ensure code quality and consistency, effectively improving team collaboration efficiency.

• Dynamic Routing: Backend-driven dynamic routing combined with the RBAC (Role-Based Access Control) permission model provides fine-grained menu and route control.

• JWT Authentication: Uses JSON Web Token (JWT) for authentication and authorization, enhancing application security.

• Fine-Grained Permission Control: Implements button-level and API-level permission controls, ensuring that different users or roles have different access restrictions when interacting with the interface and accessing APIs.

5. Tech Stack

Quick Start

Method 1: Pull the Image from Docker Hub

docker pull mizhexiaoxiao/vue-fastapi-admin:latest
docker run -d --restart=always --name=vue-fastapi-admin -p 9999:80 mizhexiaoxiao/vue-fastapi-admin

Method 2: Build the Image Using a Dockerfile

Install Docker (Version 17.05+)

yum install -y docker-ce
systemctl start docker

Build the Image

Visit Yifei Open Source: https://code.exmay.com/ Download
cd vue-fastapi-admin
docker build --no-cache . -t vue-fastapi-admin

Start the Container

docker run -d --restart=always --name=vue-fastapi-admin -p 9999:80 vue-fastapi-admin

Access

http://localhost:9999

username：admin

password：123456

Local startup

Backend

The following environment is required to start the project:

• Python 3.11

• Poetry

1. Create a Virtual Environment

poetry shell

2. Install Dependencies

poetry install

3. Start the service

make run

The service should now be running. Visit [http://localhost:9999/docs](http://localhost:9999/docs) to view the API documentation.

Frontend

The following environment is required to start the project:

• node v18.8.0+

1. Navigate to the Frontend Directory

cd web

2. Install Dependencies (pnpm is recommended)

npm i -g pnpm # Ignore if already installed
pnpm i # Or use npm i

3. Start the Project

pnpm dev