Merge v4 docs

.vitepress/config.mts

@@ -16,7 +16,7 @@ export default defineConfig({
   srcExclude: ['tutorial/**/description.md'],
 
   title: 'Leaf PHP',
-  description: 'Simple and elegant PHP',
+  description: 'Elegant PHP, Built for Makers',
 
   themeConfig: {
     nav,
@@ -75,6 +75,10 @@ export default defineConfig({
 
   markdown: {
     lineNumbers: true,
+    theme: {
+      light: 'one-dark-pro',
+      dark: 'one-dark-pro',
+    },
     config(md) {
       md.use(groupIconMdPlugin);
     },
@@ -83,4 +87,8 @@ export default defineConfig({
   vite: {
     plugins: [groupIconVitePlugin()],
   },
+
+  rewrites: {
+    '/api/': '/api/app.html',
+  }
 });

.vitepress/config/head.ts

@@ -13,7 +13,7 @@ const head: HeadConfig[] = [
     {
       name: 'description',
       content:
-        'Leaf is a lightweight and user-friendly framework designed for quick and efficient development. It features a zero-config setup and an ecosystem of tools, making it ideal for building scalable apps with ease.',
+        'Leaf is a lightweight and elegant PHP framework built for makers. With zero-config setup and an ecosystem of powerful tools, Leaf helps you build and ship scalable apps—fast',
     },
   ],
   ['meta', { name: 'twitter:site', content: '@leafphp' }],
@@ -23,15 +23,15 @@ const head: HeadConfig[] = [
     'meta',
     {
       name: 'twitter:title',
-      content: 'Leaf PHP - Elegant PHP for Modern Development',
+      content: 'Leaf PHP - Elegant PHP, Built for Makers',
     },
   ],
   [
     'meta',
     {
       name: 'twitter:description',
       content:
-        'Leaf is a lightweight and user-friendly framework designed for quick and efficient development. It features a zero-config setup and an ecosystem of tools, making it ideal for building scalable apps with ease.',
+        'Leaf is a lightweight and elegant PHP framework built for makers. With zero-config setup and an ecosystem of powerful tools, Leaf helps you build and ship scalable apps—fast',
     },
   ],
   [
@@ -46,7 +46,7 @@ const head: HeadConfig[] = [
     'meta',
     {
       name: 'og:title',
-      content: 'Leaf PHP - Elegant PHP for Modern Development',
+      content: 'Leaf PHP - Elegant PHP, Built for Makers',
     },
   ],
   [
@@ -76,7 +76,7 @@ const head: HeadConfig[] = [
     {
       name: 'og:description',
       content:
-        'Leaf is a lightweight and user-friendly framework designed for quick and efficient development. It features a zero-config setup and an ecosystem of tools, making it ideal for building scalable apps with ease.',
+        'Leaf is a lightweight and elegant PHP framework built for makers. With zero-config setup and an ecosystem of powerful tools, Leaf helps you build and ship scalable apps—fast',
     },
   ],
   [
@@ -128,7 +128,22 @@ const head: HeadConfig[] = [
   [
     'link',
     {
-      href: 'https://fonts.googleapis.com/css?family=DM+Mono:ital,wght@0,300;0,400;0,500;1,300;1,400;1,500|DM+Sans:ital,wght@0,400;0,500;0,700;1,400;1,500;1,700|Inter:300,400,500,600|Open+Sans:400,600;display=swap',
+      href: 'https://fonts.googleapis.com',
+      rel: 'preconnect',
+    },
+  ],
+  [
+    'link',
+    {
+      href: 'https://fonts.gstatic.com',
+      rel: 'preconnect',
+      crossorigin: '',
+    },
+  ],
+  [
+    'link',
+    {
+      href: 'https://fonts.googleapis.com/css2?family=Bricolage+Grotesque:opsz,wght@12..96,200..800&family=DM+Mono:ital,wght@0,300;0,400;0,500;1,300;1,400;1,500&display=swap',
       rel: 'stylesheet',
     },
   ],

.vitepress/config/navbar.ts

@@ -4,107 +4,28 @@ const nav: DefaultTheme.NavItem[] = [
   {
     text: 'Docs',
     activeMatch: `^/(docs|examples)/`,
-    items: [
-      { text: 'Guide', link: '/docs/' },
-      { text: 'Tutorial', link: '/tutorial/' },
-      {
-        text: 'Leaf + MVC',
-        link: '/docs/mvc/',
-      },
-      {
-        text: 'Leaf Modules',
-        link: '/docs/modules',
-      },
-      {
-        text: 'Leaf CLI',
-        link: '/docs/cli/',
-      },
-      {
-        text: 'MVC Console',
-        link: '/docs/mvc/console/',
-      },
-    ],
+    link: '/docs/',
   },
-
   {
-    text: 'Ecosystem',
-    activeMatch: `^/ecosystem/`,
-    items: [
-      {
-        text: 'Resources',
-        items: [
-          { text: 'Online Playground', link: 'https://sandbox.leafphp.dev/' },
-          {
-            text: 'Codelabs',
-            link: '/codelabs/',
-          },
-          // {
-          //   text: 'Leaf UI',
-          //   link: 'https://ui.leafphp.dev/',
-          // },
-        ],
-      },
-      {
-        text: 'Other',
-        items: [
-          {
-            text: 'Hana JS',
-            link: 'https://hana.leafphp.dev',
-          },
-          {
-            text: 'Naytive',
-            link: 'https://naytive.netlify.app',
-          },
-        ],
-      },
-      {
-        text: 'Help',
-        items: [
-          // {
-          //   text: 'Leaf Forum',
-          //   link: 'https://github.com/leafsphp/leaf/discussions/37',
-          // },
-          {
-            text: 'YouTube',
-            link: 'https://www.youtube.com/channel/UCllE-GsYy10RkxBUK0HIffw',
-          },
-          {
-            text: 'Discord',
-            link: 'https://discord.gg/Pkrm9NJPE3',
-          },
-          {
-            text: 'GitHub',
-            link: 'https://github.com/leafsphp/leaf',
-          },
-        ],
-      },
-    ],
+    text: 'Blog',
+    link: 'https://blog.leafphp.dev',
   },
-
   {
     text: 'Community',
     activeMatch: `^/(about|community)/`,
     items: [
-      {
-        text: 'Leaf Community',
-        link: '/community/',
-      },
       {
         text: 'Contribute to Leaf',
         link: '/community/guide',
       },
-      {
-        text: 'Changelog',
-        link: '/community/releases',
-      },
+      // {
+      //   text: 'Changelog',
+      //   link: '/community/releases',
+      // },
       // {
       //   text: 'Project Showcase',
       //   link: '/community/showcase',
       // },
-      {
-        text: 'Blog',
-        link: 'https://blog.leafphp.dev',
-      },
       {
         text: 'Team',
         link: '/community/team',

.vitepress/config/sidebar.ts

@@ -4,23 +4,22 @@ const sidebar = [
     // collapsible: true,
     // collapsed: true,
     items: [
-      { text: 'Introduction', link: '/docs/' },
-      { text: 'Installation', link: '/docs/installation' },
+      // { text: 'Installation', link: '/docs/installation' },
+      { text: 'Leaf CLI', link: '/docs/cli/' },
       { text: 'Migration Guide', link: '/docs/migrating' },
       // { text: 'Functional Mode', link: '/docs/config/functional-mode' },
       { text: 'Modules', link: '/docs/modules' },
     ],
   },
-  {
-    text: 'Leaf CLI',
-    // collapsible: true,
-    // collapsed: true,
-    items: [
-      { text: 'CLI Intro', link: '/docs/cli/' },
-      { text: 'Creating apps', link: '/docs/cli/creating-an-app' },
-      { text: 'Managing apps', link: '/docs/cli/managing-apps' },
-    ],
-  },
+  // {
+  //   text: 'Leaf CLI',
+  //   // collapsible: true,
+  //   // collapsed: true,
+  //   items: [
+  //     { text: 'Creating apps', link: '/docs/cli/creating-an-app' },
+  //     { text: 'Managing apps', link: '/docs/cli/managing-apps' },
+  //   ],
+  // },
   {
     text: 'Routing',
     // collapsible: true,
@@ -30,7 +29,7 @@ const sidebar = [
       { text: 'Route Groups', link: '/docs/routing/route-groups' },
       { text: 'Dynamic routing', link: '/docs/routing/dynamic' },
       { text: 'Middleware', link: '/docs/routing/middleware/' },
-      { text: 'Middleware in Leaf MVC', link: '/docs/routing/middleware/mvc' },
+      // { text: 'Middleware in Leaf MVC', link: '/docs/routing/middleware/mvc' },
     ],
   },
   {
@@ -52,7 +51,7 @@ const sidebar = [
       // { text: 'Overview', link: '/docs/config/' },
       // { text: 'App settings', link: '/docs/config/settings' },
       { text: 'Application Env', link: '/docs/config/environment' },
-      { text: 'URL Rewriting', link: '/docs/routing/url-rewriting' },
+      { text: 'Deployment', link: '/learn/deployment/' },
       { text: 'Error Handling', link: '/docs/routing/error-handling' },
       { text: 'Dependency Injection', link: '/docs/config/container' },
       // { text: 'Logging', link: '/docs/utils/logging' },
@@ -126,7 +125,7 @@ const sidebar = [
       { text: 'HTTP Cache', link: '/docs/http/caching' },
       { text: 'Leaf Mail', link: '/docs/utils/mail/' },
       { text: 'File System', link: '/docs/utils/fs' },
-      // { text: 'Queues/Jobs', link: '/docs/utils/queues' },
+      { text: 'Queues/Jobs', link: '/docs/utils/queues' },
     ],
   },
   {
@@ -141,25 +140,41 @@ const sidebar = [
       { text: 'Vite JS', link: '/docs/frontend/vite' },
       { text: 'Tailwind CSS', link: '/docs/frontend/tailwind' },
       { text: 'Inertia JS', link: '/docs/frontend/inertia' },
-      // { text: 'Viewi PHP', link: '/docs/frontend/viewi' },
       // { text: 'Leaf UI', link: '/docs/frontend/leaf-ui' },
+      // {
+      //   text: 'Leaf Zero',
+      //   collapsible: true,
+      //   collapsed: true,
+      //   items: [
+      //     { text: 'Introduction', link: '/docs/frontend/zero/' },
+      //     { text: 'Layouts', link: '/docs/frontend/zero/layouts' },
+      //     { text: 'Forms', link: '/docs/frontend/zero/forms' },
+      //     { text: 'Modals', link: '/docs/frontend/zero/modals' },
+      //     { text: 'Alerts', link: '/docs/frontend/zero/alerts' },
+      //     { text: 'Loading', link: '/docs/frontend/zero/loading' },
+      //     { text: 'Icons', link: '/docs/frontend/zero/icons' },
+      //     { text: 'Forms', link: '/docs/frontend/zero/forms' },
+      //     { text: 'Merketing Sections', link: '/docs/frontend/zero/marketing' },
+      //     { text: 'Dashboard Sections', link: '/docs/frontend/zero/dashboard' },
+      //   ],
+      // },
     ],
   },
   {
     text: 'Building to scale',
     // collapsible: true,
     // collapsed: true,
     items: [
-      { text: 'Leaf + MVC', link: '/docs/mvc/' },
-      { text: 'Leaf MVC v4', link: '/docs/mvc/mvc4' },
+      // { text: 'Leaf + MVC', link: '/docs/mvc/' },
+      // { text: 'Leaf MVC v4', link: '/docs/mvc/mvc4' },
       { text: 'Controllers', link: '/docs/mvc/controllers' },
       // { text: 'Views', link: '/docs/frontend/mvc' },
       { text: 'Models', link: '/docs/database/models' },
-      { text: 'Migrations', link: '/docs/database/migrations' },
-      { text: 'JSON Schema', link: '/docs/database/schema' },
+      // { text: 'Migrations', link: '/docs/database/migrations' },
+      // { text: 'JSON Schema', link: '/docs/database/schema' },
       { text: 'Schema Files', link: '/docs/database/files' },
-      { text: 'Seeders', link: '/docs/database/seeders' },
-      { text: 'Factories', link: '/docs/database/factories' },
+      // { text: 'Seeders', link: '/docs/database/seeders' },
+      // { text: 'Factories', link: '/docs/database/factories' },
       { text: 'Writing Commands', link: '/docs/mvc/commands' },
       // { text: 'Mailing', link: '/docs/utils/mail/mvc' },
       { text: 'MVC Globals', link: '/docs/mvc/globals' },
@@ -174,8 +189,8 @@ const sidebar = [
   //   items: [
   //     { text: 'Intro', link: '/codelabs/' },
   //     { text: 'Contributing', link: '/codelabs/contributing' },
-  //     // { text: 'Deployment', link: '/codelabs/experiments/deployment/' },
-  //     // { text: 'Authentication', link: '/codelabs/experiments/auth/' },
+  //     // { text: 'Deployment', link: '/learn/deployment/' },
+  //     // { text: 'Authentication', link: '/learn/auth/' },
   //   ],
   // },
 ];

.vitepress/theme/components/Community/Blog.vue

@@ -5,32 +5,35 @@ import Button from '../shared/Button.vue';
 </script>
 
 <template>
-  <section id="blog" class="testimonials hidden md:flex justify-center items-center h-[70vh]">
-    <div class="flex:center-between py:_10" style="display: grid; grid-template-columns: 1fr 1.25fr; gap: 4rem;">
-      <div class="text-sm">
-        <h2 class="title mb-4" style="text-align: left;">Latest writings from the Leaf team</h2>
-        <p class="mb-2">
-          Our main goal and pride at Leaf is to make PHP development as simple and elegant as possible.
-        </p>
-        <p class="mb-6">
-          Our team is always looking to improve your experience using the Leaf framework and it's ecosystem of tools.
-          You
-          can follow along as our team discusses it's insights from the past year and what's to come in 2025.
-        </p>
-        <Button as="a" href="https://blog.leafphp.dev" target="_blank">
-          <span>Read the Blog</span>
-          <ExternalLink height="18px" />
-        </Button>
+  <div class="flex justify-center items-center">
+    <section id="blog"
+      class="testimonials hidden md:flex justify-center items-center h-[70vh] w-full sm:!max-w-3xl lg:!max-w-5xl xl:!max-w-7xl !px-2 sm:!px-10">
+      <div class="flex justify-center w-full items-center py:_10"
+        style="display: grid; grid-template-columns: 1fr 1.25fr; gap: 4rem;">
+        <div class="text-sm max-w-[400px]">
+          <h1 class="title mb-4" style="text-align: left;">Latest writings from the Leaf team</h1>
+          <p class="mb-2 text-base">
+            Our main goal and pride at Leaf is to make PHP development as simple and elegant as possible.
+          </p>
+          <p class="mb-6 text-base">
+            Our team is always looking to improve your experience using the Leaf framework and it's ecosystem of tools.
+            You
+            can follow along as our team discusses it's insights from the past year and what's to come in 2025.
+          </p>
+          <Button as="a" class="!text-white" href="https://blog.leafphp.dev" target="_blank">
+            <span>Read the Blog</span>
+            <ExternalLink height="18px" />
+          </Button>
+        </div>
+
+        <div class="elfsight-app-6190fe7f-f619-4dda-9952-9324f84ba50c" data-elfsight-app-lazy></div>
       </div>
-
-      <div class="elfsight-app-6190fe7f-f619-4dda-9952-9324f84ba50c" data-elfsight-app-lazy></div>
-    </div>
-  </section>
+    </section>
+  </div>
 </template>
 
 <style scoped>
 .testimonials {
-  padding: 32px 24px;
   /* padding: 42px 32px; */
   background: var(--vt-c-bg-dark);
   transition: border-color 0.5s, background-color 0.5s;
@@ -39,7 +42,6 @@ import Button from '../shared/Button.vue';
 
 .testimonials>div {
   padding: 0px 32px;
-  max-width: 900px;
 }
 
 .blog-card {