{{ step.title }}
+
+
+
+ {{ part.t }}
+
+ {{ layer.label }} · {{ layer.eyebrow }}
+{{ layer.title }}
+{{ layer.description }}
+
-
-
- Latest from Our Blog
-- At Leaf, we're focused on making PHP development as simple and elegant as possible. - Our team is constantly improving the framework and its ecosystem—tune in as we share what's new and what's - coming next. -
-
-
+
+
+
-
+
+
+
+
-
+
-
-
-
+ Building in public
+Ideas behind the way we build
++ How we think about frameworks, AI-assisted development, and shipping products that last. +
+
+
+
-
-
+
-
-
-
-
+
+
+
+ + {{ post.title }} +
++ {{ post.excerpt }} +
+
-
{{ name }}
-{{ intro }}
+ + +
+
+
- Topics
-- {{ p }} + +
+
+ ![]()
-
-
-
+
-
-
diff --git a/.vitepress/theme/components/Community/Events/Events.vue b/.vitepress/theme/components/Community/Events/Events.vue
index 837d57f1..866bb734 100644
--- a/.vitepress/theme/components/Community/Events/Events.vue
+++ b/.vitepress/theme/components/Community/Events/Events.vue
@@ -1,40 +1,117 @@
-
+
+ {{ topic }}
+
+
+
+
+ + {{ name }} +
+ + ++ {{ intro }}
-
-
-
+
+
+
+ {{ formattedDate }}
+
+
+
+
+ {{ locationLabel }}
+
+
-
-
-
-
+
+
+
+
+
+
+
+ Events
+Where the community meets
++ Leaf events, conferences, and meetups happening around the world. +
+
+
+
+
+
+
+
+
+
+
+
+
+
+ No upcoming events
++ Check back soon — or look through past events below. +
+
+
+
- Past events
+ + +
+
+
+
+
+
+
+
+ + No events match "{{ query }}". +
-
-
+
+
-
+
+
+ + No events match "{{ query }}". +
+ + diff --git a/.vitepress/theme/components/Community/NewsLetterSubstack.vue b/.vitepress/theme/components/Community/NewsLetterSubstack.vue index 00443424..dd89f743 100644 --- a/.vitepress/theme/components/Community/NewsLetterSubstack.vue +++ b/.vitepress/theme/components/Community/NewsLetterSubstack.vue @@ -1,121 +1,34 @@ - -
-
-
-
- You can read our blog posts at
- blog.leafphp.dev. You may also go social
- at
- Twitter, or join our
- discussions or
- watch our videos on
- YouTube.
+
-
-
diff --git a/.vitepress/theme/components/Community/Speak.vue b/.vitepress/theme/components/Community/Speak.vue
index d385a31c..d0c6de38 100644
--- a/.vitepress/theme/components/Community/Speak.vue
+++ b/.vitepress/theme/components/Community/Speak.vue
@@ -1,168 +1,103 @@
-
-
- Speak at an event
+ Want a Leaf core team member to speak? We'd love to bring practical Leaf 5 and AI-native PHP demos to your
+ attendees.
+
- Want a Leaf core team member to speak at your next event? Invite us to create a memorable and engaging
- experience for your attendees.
- {{ item.title }} {{ item.desc }}
- These are the heroes who have made Leaf what it is today. We are grateful for their contributions and support
- ❤️
- Contributors
+ These contributors make Leaf cleaner, faster, and easier for humans and AI tools to understand.
+ Leaf MVC
+ Leaf MVC gives your project controllers, models, routes, views, services, and environment conventions from day
+ one, while keeping the codebase small enough for humans and AI assistants to understand.
+ {{ item.value }} {{
+ item.label }} Best
+ for {{ item.title }} {{ item.description }} Request flow
+
+ A route receives the request, a controller decides what should happen, models and services handle the work,
+ and a view or JSON response returns the result. That predictable flow is why Leaf MVC works well for teams and
+ AI-assisted changes.
+ Default
+ starter {{ item.title }} {{ item.description }} {{ item.use }}
+
+ Your app is live at
+ Leaf is a PHP framework designed to stay light, while giving you production-ready pieces to handle all the heavy-lifting as soon as you need them. We rebuilt the Leaf experience with AI in mind, so you and your agents can build at the speed of thought hehe Here is the smallest possible Leaf app: And when you need more, install only what the project needs: In short, Leaf provides a streamlined development experience with all the essential tools ready to go. Before you start with Leaf, verify that your system has the following installed: If you don't have PHP and Composer installed, here are some easy options to get you set up: AI-native framework
+ Leaf makes your routes, modules, structure, conventions, and project state readable to AI, so assistants can
+ build inside your app instead of guessing around it.
+ Community
+ Build alongside developers shaping how modern products are made. Share what you're building, get help when
+ you're stuck, and compare the ways people are building with AI in real Leaf apps.
+
- Our first community meet up was in 2023 which we held together with SeevCash. Since then our community has
- gotten bigger, growing together with Leaf and all the tools in the ecosystem. Join our young but vibrant
- community and the Leaf team as we discuss our insights from the past year and what’s to come in the next
- couple of years 🚀
-
+ The Leaf Discord is where releases drop first, questions get answered, and builders show off what they're
+ shipping, from weekend projects to production apps.
+
Leaf is built for makers who move fast. Whether you are building a web app, API, microservice or console application, Leaf
gets you up and running in seconds. With no config and effortless deployment, you can run Leaf anywhere PHP is
- available—instantly!
+ available, instantly!
Ecosystem
+ Leaf is more than the framework. We're a family of focused tools that work anywhere PHP (or JavaScript) runs,
+ each with its own home.
+
- If you're tired of frameworks that dictate your frontend choices, Leaf is different. Use any frontend framework
- you prefer — Vue, React, Svelte, Blade or bring your own view engine.
- Vegan • 4 stars Spicy • 5 stars Low-carb • 4 stars Frontend
+ Use any frontend you want. Your AI assistant still gets the same backend map. Your tools follow your
+ stack. Learn more ↗
+ {{ dish.name }} {{ dish.meta }}
-
-
-
+
+
-
+
diff --git a/.vitepress/theme/components/Community/WallOfFame.vue b/.vitepress/theme/components/Community/WallOfFame.vue
index b6913f0b..95c2155b 100644
--- a/.vitepress/theme/components/Community/WallOfFame.vue
+++ b/.vitepress/theme/components/Community/WallOfFame.vue
@@ -1,25 +1,26 @@
-
+
-
+
+
+
+
+
+
+
+
-
+
-
+
+
+
+
+
+
+
+ Invite us to your next event
+
+ Invite us to speak at your next event
-
-
+
+
+
+
+
+
+
+
+
+
-
+
diff --git a/.vitepress/theme/components/Docs/MvcIntroPage.vue b/.vitepress/theme/components/Docs/MvcIntroPage.vue
new file mode 100644
index 00000000..e5fd1103
--- /dev/null
+++ b/.vitepress/theme/components/Docs/MvcIntroPage.vue
@@ -0,0 +1,250 @@
+
+
-
+ Wall of Fame
- Wall of Fame
+
+
+
+
-
- 
+
+
-
+
+
+
+
+
+
+
+
+ Structure for real apps, without the framework weight.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 0{{ index + 1 }} / {{ item.kicker }}
+ {{ item.title }}
+ {{ item.description }}
+
+
+
+
+
+
+
+ Route receives request
+
+
+
+
+
+ php
+
+
+ app()->get('/dashboard', 'DashboardController@index');
+ Controller coordinates work
+
+ Model or service handles logic
+
+
+
+
+
+ php
+
+
+ return response()->view('dashboard', [
+ 'data' => db()->select('frames')->get()
+]);
+ View or JSON returns result
+
+
+
+
+ blade
+
+
+ <h1>Dashboard</h1>
+<ul>
+ @foreach ($data as $frame)
+ <li>{{ $frame->name }}</li>
+ @endforeach
+</ul>
+
+
+
+
+
+
+
+
+
+ app/
+ controllers/
+ database/
+ models/
+ routes/
+ views/
+ public/
+
+
+
+
+
+
+
+
+
+
+
diff --git a/.vitepress/theme/components/Docs/Quickstart.vue b/.vitepress/theme/components/Docs/Quickstart.vue
new file mode 100644
index 00000000..4f683992
--- /dev/null
+++ b/.vitepress/theme/components/Docs/Quickstart.vue
@@ -0,0 +1,191 @@
+
+
+
+
+ $ leaf config:publish <config-file>
+ omit the name to publish every config
+
+
+
+
+
+ {{ item.name }}
+
+
+
+
+
+ {{ copyError || (copied ? 'Commands copied to clipboard.' : '') }}
+
+ Bash
+
+
+
+ {{ step.number }}
+
+
+
+
+
+
+ 03
+
+ http://localhost:5500
+ php
+
+
+
+
+ <?php
+
+require __DIR__ . '/vendor/autoload.php';
+
+app()->get('/', fn () => response()->json([
+ 'message' => 'Hello World!'
+]));
+
+app()->run();
+
+
+
+
+
+
+
+ {{ method.label }}
+ {{ method.hint }}
+
+
+
+
+
+
+ 0{{ index + 1 }} / {{ item.kicker }}
+ {{ item.title }}
+ {{ item.description }}
+
+
+
+
+
+
+
+
diff --git a/.vitepress/theme/components/Home/AIWorkflow.vue b/.vitepress/theme/components/Home/AIWorkflow.vue
new file mode 100644
index 00000000..d17ce9cc
--- /dev/null
+++ b/.vitepress/theme/components/Home/AIWorkflow.vue
@@ -0,0 +1,100 @@
+
+
+
+ Technical Requirements
+
+
+
+
+
+ Give your agent the context your PHP app deserves.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ You read
+ app/controllers/OrdersController.php
+
+ public function store() {
+ $data = request()->validate([
+ 'items' => 'array|required',
+ 'coupon' => 'optional|string',
+ ]);
+
+ $order = Order::create($data);
+ billing()->charge($order);
+
+ return response()->json($order);
+}
+
+
+
+ Your agent reads
+ .leaf/context.md
+
+ # my-product
+stack leaf 5 · mvc · sqlite · react/inertia
+modules auth, db, billing, queue
+
+## conventions
+routes → app/routes/*.php
+controllers → app/controllers, one per resource
+validation → request()->validate() first
+
+## recent
++ OrdersController::store charges on create
+
+
+
- 
+
+
Join other people building real products
+
-
diff --git a/.vitepress/theme/components/Home/Deploy.vue b/.vitepress/theme/components/Home/Deploy.vue
index 94bf64dc..b1536771 100644
--- a/.vitepress/theme/components/Home/Deploy.vue
+++ b/.vitepress/theme/components/Home/Deploy.vue
@@ -6,7 +6,7 @@
Dig into our vibrant
- community with us.
+
+
+
+
+
-
+
-
+
+
+ One team. A whole toolchain.
+
-
-
- Worried about
- frontend lock-in? Don't be.
-
-
-
-
-
-
-
-
-
- app()->get('/menu/items', function() {
- return response()->inertia('menu', [
- 'items' => db()->select('menu_items')->all()
- ]);
-});
-
-
-
-
+ id="frontend"
+ :class="[ui.section, ui.spacious, 'max-w-6xl']"
+ :style="{ '--fwd': fw.dark, '--fwl': fw.light }"
+ >
+
-
-
- 🍔
-
-
-
- Veggie Loaded Burger
- $8.99
-
-
-
- 🍗
-
-
-
- Southern Fried Chicken
- $9.49
-
-
-
- 🥩
-
-
-
- Healthy Beef Burger
- $8.99
- Your stack stays yours
+
+
-
-
-
+
-
-
-
+
+
+
+
+
+
+
+
+
+
+
-
+ Leaf route
+ app/routes/menu.php
- React
+
-
-
+
+
+
-
+ {{ fw.name }} view
+ app/views/{{ fw.file }}
- Vue
+
-
-
+
+
@@ -140,75 +199,22 @@
diff --git a/.vitepress/theme/components/Home/Footer.vue b/.vitepress/theme/components/Home/Footer.vue
index 01bec1f8..631da6a9 100644
--- a/.vitepress/theme/components/Home/Footer.vue
+++ b/.vitepress/theme/components/Home/Footer.vue
@@ -1,17 +1,123 @@
+
+
-
+
-
+ Rendered by {{ fw.name }}
+
- Svelte
-
-
-
+
+
- Blade
+
+
+ {{ dish.price }}
+