BuildAdmin: Vue3 ThinkPHP8 Panel With Visual CRUD Builder

BuildAdmin is an administrative framework powered by Vue 3.x, ThinkPHP 8, TypeScript, Vite, Pinia, and Element Plus. It supports memory-resident execution, visual CRUD generation, an integrated web terminal, and responsive layouts for various devices. The project is distributed with dedicated packages for Web, WebNuxt, and Server environments. Key features include a global recycle bin, field-level data protection, auto-registered routes, and an infinite nested permission system. The code is open-source and free for commercial use without licensing restrictions.

Visual CRUD Generator Eliminate repetitive boilerplate by using a visual interface to generate backend CRUD logic. This tool allows you to create data tables via a drag-and-drop interface, selecting from 24 different form components. You can reorder rows intuitively and rely on built-in, permission-aware edit and delete actions. It handles relational tables automatically, significantly reducing development overhead.

Built-In Web Terminal BuildAdmin integrates a terminal directly into the local development environment. This allows you to set up the Vue 3 system without manually running npm install. Once the CRUD generator finishes its task, Prettier automatically formats the resulting code. The terminal can execute any command available in your environment variables, functioning as a native component of the workflow rather than an afterthought.

Solid Stack The backend utilizes ThinkPHP 8 in a decoupled architecture, while the frontend relies on the Vue 3 Composition API (setup, useTemplateRef), Pinia for state management, TypeScript, and Vite. This combination ensures full compatibility with the broader Vue 3 and PHP 8.x ecosystems, allowing external libraries and components to be integrated without friction.

Module Market Expand the system’s functionality by installing data tools, SMS gateways, payment integrations, cloud storage drivers, and rich text editors with a single click. The system automatically manages updates to package.json and composer.json, while the integrated terminal handles the resolution and installation of all new dependencies.

Decoupled Architecture The web directory contains a clean, self-contained frontend codebase, entirely separate from backend logic. Frontend developers can use BuildAdmin as a structured resource hub, focusing on UI and UX within a prepared environment without needing to understand or modify the backend.

Memory-Resident Runtime For high-performance needs, the Workerman module provides an HTTP service that is significantly faster than traditional PHP-FPM setups. The system also includes an out-of-the-box WebSocket server for real-time applications.

Lazy Loading Frontend components and language packs are loaded asynchronously only when needed. On the backend, ThinkPHP 8 and PSR compliance ensure true on-demand resource loading. The system doesn't just hide unused features; it avoids loading them entirely.

Data Recovery and Audit A global recycle bin prevents accidental data loss by catching deleted records. Field-level change logs and diff views allow you to inspect and roll back individual edits. This protection layer operates quietly in the background until it is required.

Clean Interface Users can choose from three layout modes, featuring a default borderless design. UI elements "float" on the screen to maximize white space and reduce visual clutter, moving away from restrictive grid lines and divider bars. This design ensures the workspace is efficient without feeling cramped.

Granular Permissions Access management is handled through a visual interface. Routes, menus, pages, and buttons register dynamically based on permission nodes. Permission groups can be nested indefinitely, and the system performs validation on both the frontend and backend to ensure security.

Roles and Users BuildAdmin includes comprehensive modules for administrator groups, user activity logs, membership tiers, balance tracking, point management, and media assets. More advanced features become visible as you navigate the system.

Getting Started You do not need to configure a virtual host (like Nginx or Apache) for local development.

Clone the repository or download the package, ensuring your environment meets these requirements:

• PHP >= 8.0.2 (x64)
• MySQL >= 5.7 (with InnoDB support)
• Node.js >= 20.14.0
• npm >= 9.8.1
• Composer (required if cloning via Git)

From the project root (where the think file is located):

cd buildadmin
composer install  # Skip this if using the pre-packaged version
php think run

The development server will start at http://0.0.0.0:8000/. Open http://127.0.0.1:8000/ in your browser to start the installation wizard.

To stop the server, press Ctrl+C. For production environments, point your web server to the buildadmin/public directory.

Troubleshooting Quick Hits

• If the web terminal fails to connect, verify your folder permissions and ensure you are accessing the site via the IP:8000 address.
• If you see security errors, check if necessary functions are disabled in your php.ini file and enable them.
• If the composer command is not found, try using composer.phar install or update your system's PATH.
• If extensions like fileinfo are missing, install them through your PHP package manager.
• On Linux, use sudo php think run if you encounter permission errors during startup.