Introduction

What is Lacelium?

Lacelium is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and truly fulfilling experience to be creative. Lacelium takes the pain out of development by easing common tasks used in many web projects, such as:

• Simple, fast routing engine with full controller and macro support.
• Powerful dependency injection container.
• Robust database abstraction with Eloquent ORM and schema migrations.
• Integrated Twig 3.x templating engine with inherited shared layouts.
• Zero-latency real-time broadcasting powered by the native Nexify engine (unified host and port).
• Visual database management and scaffolding via ArgusKit Studio.

Why Choose Lacelium?

There are numerous PHP frameworks in the software ecosystem, from heavyweight enterprise stacks to micro-routers. Lacelium was designed specifically for developers who demand the developer experience of Laravel combined with lightweight footprint, minimal dependencies, and instant startup times.

Progressive Architecture

Lacelium scales effortlessly with the complexity of your project. If you are building a small internal dashboard, the built-in SQLite driver and ArgusKit Studio allow you to generate full CRUD workflows in minutes. As your application grows into a high-concurrency SaaS platform, Lacelium runs seamlessly under RoadRunner workers or clustered PHP-FPM servers.

Deep "Dipperlook" Tooling

Unlike micro-frameworks that force you to assemble dozens of third-party libraries for caching, file storage, and CLI tasks, Lacelium provides the integrated Dipperlook subsystems suite. Out of the box, you have access to multi-driver cache, unified virtual filesystems (local, S3, R2), a fluent HTTP client, multi-language localization, and hardened security guards.

Typical Request Lifecycle

Understanding how a request moves through Lacelium helps you write cleaner, more maintainable code:

1. Entry Point: All requests enter through public/index.php, which initializes the Composer autoloader and boots the application kernel.
2. Routing & Middleware: The HTTP Foundation resolves the URI against config/routes.php and executes any assigned middleware filters (e.g. CSRF validation, authentication, sessions).
3. Controller Action: The matched controller method is invoked, using dependency injection to provide request objects and services.
4. Model & Persistence: Business logic interacts with Eloquent models, running prepared SQL statements via PDO.
5. View Rendering: The controller passes data into a Twig template, which renders the finalized HTML markup and streams the response back to the client.

Next Steps

Ready to get started? We recommend continuing with the following guides:

• Installation Guide: Set up your local environment and run the development server.
• Configuration: Learn how application settings and environments work.
• Directory Structure: Tour the organization of a fresh Lacelium application.
• ArgusKit Studio: Explore the visual maintenance and schema generator.