The Developer’s Guide to XIUNOX: PHP 8, Bootstrap 5.3, and a Plugin System That Grows With You

Bringing the Lightweight Forum into the Modern Era

After years of faithful service, the classic Xiuno BBS needed a serious upgrade. Enter XIUNOX (currently at version v1.1.0) – not just a patch, but a complete modern rebuild of Xiuno BBS 4.0.4. Originally prototyped under the names ‘Xiuno BBS v4.5+’ and ‘Xiuno Next’, XIUNOX keeps the core philosophy of being lightweight and fast, while rewriting the entire stack from the ground up. It’s built for PHP 8.0+ and MySQL 8, embraces the latest front-end technologies, and adds a host of features that make it a viable choice for today’s community builders.

Tech Stack: A Carefully Curated Set of Tools

XIUNOX isn’t just a random collection of libraries – each component has been chosen to solve a specific problem without bloat.

• Backend: PHP 8.0+ with PDO for MySQL 8. This means better performance, strict typing, and modern syntax. The switch to MySQL 8 brings native JSON support, window functions, and improved indexing.
• Frontend: Bootstrap 5.3 for responsive layout, but the real star is htmx 4.1 (with hx-live and hx-optimistic extensions). This enables server-rendered partial updates, optimistic UI, and morph DOM preservation – no heavy JavaScript framework needed.
• Editor: AIEditor, which integrates seamlessly with the built-in AIService. It provides AI-powered writing assistance (continuation, optimization) and supports multiple AI providers.
• Animation: anime.js for smooth transitions and micro-interactions.
• Caching: Choose between MySQL, Redis, Memcached, or Yac to suit your hosting setup.
• API: RESTful v1 API with Token authentication, making it easy to build mobile apps or integrate with external services.

Core Features That Make a Difference

1. Responsive & HTMX-Driven UI

Every page adapts to screen size – mobile, tablet, desktop. But the real magic is how htmx handles user interactions. Posting, editing, deleting – all happen without full page reloads. Optimistic updates (via hx-optimistic) instantly reflect your action while the server confirms, and morph DOM retains focus and scroll position. The result? A snappy, app-like feel without the complexity of React or Vue.

2. Plugin System That Doesn’t Break

Developers can hook into almost any event with hook + overwrite system. A built-in plugin scanner detects new plugins automatically, and if a plugin crashes your forum, XIUNOX disables it and sends you a notification. No more white screen of death.

3. Multilingual Out of the Box

Chinese (Simplified & Traditional) and English are fully supported. Adding a new language involves simply adding a language file – the entire UI and system messages respect the locale.

4. Attachment Manager with Thumbnails & Video Info

Uploaded images get auto-generated thumbnails; videos are detected (using ffprobe if available) and their metadata stored. A built-in cropping tool lets admins resize attachments directly in the admin panel.

5. Points & Reputation System

Multiple point types, daily limits, and a full audit log. You can configure how users earn or spend points (e.g., posting, liking, downloading attachments). Great for gamification or pay-per-content models.

6. Security Hardened

XIUNOX takes security seriously: CSRF tokens on all forms, XSS protection via EscapeService, parameterized queries against SQL injection, login rate limiting (to prevent brute force), and a comprehensive operation audit log. An IP blacklist, captcha, and sensitive word filter provide extra layers.

7. AI Service Integration

The AIService abstracts multiple AI providers (e.g., OpenAI, local models). The AIEditor uses this service to offer ‘continue writing’ or ‘optimize text’ suggestions directly inside the editor. Admins can configure API keys and model settings from the backend.

8. Code Highlighting & Charts

Code blocks in posts are highlighted using highlight.js (loaded only when needed – on the post detail page). For data visualization, Chart.js is available to create beautiful charts (e.g., user activity, post statistics).

9. QR Code Generation

Share links via QR code using qrcode.js – useful for mobile sharing or conference halls.

10. Full Administration Panel

Manage users, forums, plugins, themes, security settings, AI services, and more. The admin panel is also responsive and uses the same htmx principles for smooth navigation.

Why Choose XIUNOX Over Other Forums?

If you want a modern forum that doesn’t require a team of React developers to maintain, XIUNOX is a breath of fresh air. It stays true to Xiuno’s original promise of being lightweight (around 2 MB for the core), but adds the features users expect in 2024: dark mode (via Bootstrap), real-time interactions via htmx, AI integration, and a restful API that allows headless operation. The migration path from classic Xiuno BBS is straightforward thanks to the similar database structure.

Whether you’re running a niche community, a support forum, or a gaming group, XIUNOX gives you the performance of a lean PHP app with the polish of a modern web application.