Welcome to Chapter 1 of the official VlahX Technical Documentation Series! VlahX Engine 2.0 is designed from the ground up as an ultra-fast, modular, and decoupled web application platform powered by Python 3.11+ (FastAPI), SQLAlchemy, Jinja2 Templates, and Bootstrap 5.

1. High-Performance Core Architecture

Unlike traditional heavy monolithic CMS frameworks, VlahX Engine relies on FastAPI for asynchronous non-blocking routing, delivering near-instant response times and high concurrency handling:

  • Asynchronous Core: Native AsyncIO HTTP request execution via Uvicorn.
  • Single Source of Truth (SQLite): Application configuration is stored dynamically in the plugin_settings database table, eliminating brittle config files.
  • Decoupled Extensibility: Features such as OAuth 2.0 SSO, Telegram Bot notifications, and MiniShop are built as isolated plugins.

2. Multi-Theme Engine & Template Hooks

VlahX Core 2.0 separates theme presentation from backend logic:

/app/themes/<theme_slug>/
├── theme.json            # Theme Metadata Manifest
└── templates/             # Jinja2 Overrides (base.html, navbar.html, footer.html)

Plugins inject UI elements dynamically using standard Template Hooks (e.g. {{ plugin_area_login_options | safe }} and {{ plugin_area_post_after | safe }}).

3. Seamless Internationalization (i18n)

Language selection via ?lang= query parameter is automatically preserved across all internal navigation links, article listings, theme partials, and footers.

What's Next in Chapter 2?
In Chapter 2 of our Technical Series, we will explore the VlahX Plugin SDK, building custom template hooks, and managing SQLite plugin settings.