How to Set Up AJ-Report: A Spring Boot & Vue Visual Dashboard Tool

Recently I discovered an interesting open‑source project called AJ‑Report , a GVIP project on Gitee that offers a free visual drag‑and‑drop design tool for large‑screen dashboards.

The backend is built with Spring Boot, MyBatis‑Plus, and Flyway for database version management, while the frontend uses the Vue ecosystem, Element UI, and Avue, a low‑code framework that generates pages from JSON configurations.

Key repository links:

Project address: https://gitee.com/anji-plus/report

Online documentation: https://report.anji-plus.com/report-doc/

To try it online, visit https://report.anji-plus.com/index.html (guest/guest).

Project Environment Setup

First clone the repository:

git clone https://gitee.com/anji-plus/report.git

Project Structure Overview

Use the ll command to view the directory layout. Focus on four folders: report-core: backend project report-ui: frontend project doc: online documentation source build.sh: deployment script

Backend Setup

Open report-core in an IDE (e.g., IDEA) and edit bootstrap-dev.yml to configure your MySQL connection. If you need file upload, adjust the additional configuration files shown in the images.

After configuration, start the backend and verify it runs locally.

Frontend Setup

Ensure Node.js is installed. Windows users can follow Microsoft’s guide, while macOS users can install via Homebrew: brew install node Verify installations with:

node -v

npm -v

Navigate to uexam/source/vue, then install dependencies and start the project:

npm install

npm start

Check package.json scripts to understand how the frontend is built and served.

Usage Experience

1. Configure a data source (MySQL, Elasticsearch SQL, Kudu Impala, HTTP).

2. Write SQL to define datasets, using the chosen data source.

3. Drag components onto the canvas to design a dashboard, then preview the generated large‑screen layout.

References

Flyway: https://flywaydb.org/

Microsoft Docs – Set up Node.js on Windows: https://docs.microsoft.com/zh-cn/windows/dev-environment/javascript/nodejs-on-windows