feat: add api reference

Author: mychidarko

.vitepress/config.mts

@@ -87,4 +87,8 @@ export default defineConfig({
   vite: {
     plugins: [groupIconVitePlugin()],
   },
+
+  rewrites: {
+    '/api/': '/api/app.html',
+  }
 });

.vitepress/config/head.ts

@@ -162,24 +162,24 @@ const head: HeadConfig[] = [
   //     'utf-8'
   //   ),
   // ],
-  [
-    'script',
-    {
-      async: '',
-      src: 'https://www.googletagmanager.com/gtag/js?id=G-QGZVHHLK12',
-    },
-  ],
-  [
-    'script',
-    {},
-    `
-        window.dataLayer = window.dataLayer || [];
-        function gtag(){dataLayer.push(arguments);}
-        gtag('js', new Date());
+  // [
+  //   'script',
+  //   {
+  //     async: '',
+  //     src: 'https://www.googletagmanager.com/gtag/js?id=G-QGZVHHLK12',
+  //   },
+  // ],
+  // [
+  //   'script',
+  //   {},
+  //   `
+  //       window.dataLayer = window.dataLayer || [];
+  //       function gtag(){dataLayer.push(arguments);}
+  //       gtag('js', new Date());
 
-        gtag('config', 'G-QGZVHHLK12');
-      `,
-  ],
+  //       gtag('config', 'G-QGZVHHLK12');
+  //     `,
+  // ],
 ];
 
 export default head;

.vitepress/config/navbar.ts

@@ -10,7 +10,6 @@ const nav: DefaultTheme.NavItem[] = [
     text: 'Blog',
     link: 'https://blog.leafphp.dev',
   },
-
   {
     text: 'Community',
     activeMatch: `^/(about|community)/`,

.vitepress/theme/components/Home/Hero.vue

@@ -39,8 +39,8 @@ import Particles from './Particles.vue';
                     class="size-3 rounded-full bg-gray-950/5 dark:bg-white/20"></span><span class="size-3 rounded-full bg-gray-950/5 dark:bg-white/20"></span>
                 </div>
                 <pre>
-  <code>$ composer global require leafs/cli:v4.0-beta</code>
-  <code>$ leaf create app</code>
+  <code>$ composer global require leafs/cli:v4.0-beta -W</code>
+  <code>$ leaf create app-name</code>
   <code>$ cd app</code>
                 </pre>
               </div>

.vitepress/theme/components/shared/SidebarLinks.vue

@@ -60,7 +60,7 @@ const links = [
           </svg>`
   },
   {
-    name: 'Playground',
+    name: 'Sandbox',
     href: 'https://sandbox.leafphp.dev/',
     color: 'group-hover:shadow-blue-200 dark:group-hover:bg-blue-500',
     icon: `<svg class="h-6 w-6" viewBox="0 0 24 24" fill="none">
@@ -90,8 +90,8 @@ const links = [
           </svg>`
   },
   {
-    name: 'Community',
-    href: 'https://discord.gg/Pkrm9NJPE3',
+    name: 'API Reference',
+    href: '/api/',
     color: 'group-hover:shadow-violet-200 dark:group-hover:bg-violet-500',
     icon: `<svg class="h-6 w-6" viewBox="0 0 24 24" fill="none">
             <path fill-rule="evenodd" clip-rule="evenodd"

src/api/index.md

@@ -0,0 +1 @@
+<meta http-equiv="refresh" content="0;url=/api/index.html" />

src/docs/cli/index.md

@@ -32,13 +32,38 @@ composer --version
 To install the Leaf CLI, you can run the following command:
 
 ```bash:no-line-numbers
-composer global require leafs/cli
+composer global require leafs/cli:v4.0-beta -W
 ```
 
-This tells Composer to install the Leaf CLI globally on your system. You can verify that the CLI is installed correctly by running:
+This tells Composer to install the Leaf CLI globally on your system. You can verify that the CLI is installed correctly by typing `leaf` in your terminal:
 
 ```bash:no-line-numbers
-leaf --version
+
+ _              __    ___ _    ___ 
+| |   ___ __ _ / _|  / __| |  |_ v4.0-beta
+| |__/ -_) _` |  _| | (__| |__ | | 
+|____\___\__,_|_|    \___|____|___|                       
+     
+
+Usage:
+  command [options] [arguments]
+
+Options:
+  -h, --help  -  Display help for the given command.
+  -V, --version  -  Display this application version
+
+Available commands:
+  list — List commands
+  create — Create a new Leaf project
+  update — Update leaf cli to the latest version
+  install — Install a new package
+  uninstall — Uninstall a package
+  serve — Run a server to serve your Leaf app
+  interact — Interact with your application
+  run — Run a script in your composer.json
+  view:build — Build your frontend assets
+  view:install — Set up a new view engine
+
 ```
 
 ::: details [Error] command not found: leaf

src/docs/index.md

@@ -42,7 +42,11 @@ Leaf is built to be incrementally adoptable: use it as a lightweight core for sm
 
 ::: details Technical Requirements
 
-Before you start with Leaf, verify that your system has PHP v7.4+, Composer (for package management) and [Leaf CLI](/docs/cli/) (optional but recommended for easier app management)
+Before you start with Leaf, verify that your system has the following installed:
+
+- PHP v7.4 or higher
+- Composer (for package management)
+- [Leaf CLI](/docs/cli/) (optional but recommended for easier app management)
 
 ::: details Don't have PHP & Composer installed?
 
@@ -57,7 +61,7 @@ Before you start with Leaf, verify that your system has PHP v7.4+, Composer (for
 Once you install PHP and Composer, you can proceed with the installation of Leaf CLI:
 
 ```bash:no-line-numbers
-composer global require leafs/cli
+composer global require leafs/cli:v4.0-beta -W
 ```
 
 ### Building your first app