Xboard/README.md
xboard 25c71c60ac
Some checks are pending
Docker Build and Publish / build (push) Waiting to run
update docs
2025-01-22 21:01:18 +08:00

3.1 KiB

Xboard

Telegram PHP MySQL License

📖 Introduction

Xboard is a modern panel system built on Laravel 11, focusing on providing a clean and efficient user experience.

Features

  • 🚀 Built with Laravel 11 + Octane for significant performance gains
  • 🎨 Redesigned admin interface (React + Shadcn UI)
  • 📱 Modern user frontend (Vue3 + TypeScript)
  • 🐳 Ready-to-use Docker deployment solution
  • 🎯 Optimized system architecture for better maintainability

🚀 Quick Start

git clone -b compose --depth 1 https://github.com/cedar2025/Xboard && \
cd Xboard && \
docker compose run -it --rm \
    -e ENABLE_SQLITE=true \
    -e ENABLE_REDIS=true \
    -e ADMIN_ACCOUNT=admin@demo.com \
    web php artisan xboard:install && \
docker compose up -d

After installation, visit: http://SERVER_IP:7001
⚠️ Make sure to save the admin credentials shown during installation

📖 Documentation

🔄 Upgrade Notice

🚨 Important: This version involves significant changes. Please strictly follow the upgrade documentation and backup your database before upgrading. Note that upgrading and migration are different processes, do not confuse them.

Deployment Guides

Migration Guides

🛠️ Tech Stack

  • Backend: Laravel 11 + Octane
  • Admin Panel: React + Shadcn UI + TailwindCSS
  • User Frontend: Vue3 + TypeScript + NaiveUI
  • Deployment: Docker + Docker Compose
  • Caching: Redis + Octane Cache

📷 Preview

Admin Preview

User Preview

⚠️ Disclaimer

This project is for learning and communication purposes only. Users are responsible for any consequences of using this project.

🌟 Maintenance Notice

This project is currently under light maintenance. We will:

  • Fix critical bugs and security issues
  • Review and merge important pull requests
  • Provide necessary updates for compatibility

However, new feature development may be limited.

🔔 Important Notes

  1. Restart required after modifying admin path:
docker compose restart
  1. For aaPanel installations, restart the Octane daemon process

🤝 Contributing

Issues and Pull Requests are welcome to help improve the project.

📈 Star History

Stargazers over time