chore: wip

Author: chrisbbreuer

.stacks/core/router/src/index.ts

@@ -1,7 +1,7 @@
-import { type Route, type RouteCallback, type RouteGroupOptions } from '@stacksjs/types'
+import type { Route, RouteCallback, RouteGroupOptions } from '@stacksjs/types'
 import { handleRequest } from './server'
 import { projectPath } from '@stacksjs/path'
-import { readTextFile } from '@stacksjs/storage'
+
 export class Router {
   private routes: Route[] = []
 
@@ -90,4 +90,4 @@ export class Router {
   }
 }
 
-export const route: Router = new Router() satisfies Router
+export const route = new Router()

.stacks/core/vite/src/plugin/docs.ts

@@ -15,8 +15,6 @@ export function docsEngine() {
   const host = domainParts.join('.')
   const docsUrl = `https://${host}`
 
-  console.log('docssssUrl', docsUrl)
-
   return {
     name: 'stacks-plugin',
     configureServer(server: DevServer) {

config/docs.ts

@@ -1,4 +1,3 @@
-import { path as p } from '@stacksjs/path'
 import type { DocsConfig } from '@stacksjs/types'
 
 const nav = [
@@ -28,7 +27,9 @@ const sidebar = {
       items: [
         { text: 'APIs', link: '/guide/apis' },
         { text: 'Apps', link: '/guide/apps' },
+        { text: 'Buddy', link: '/guide/buddy' },
         { text: 'CI / CD', link: '/guide/ci' },
+        { text: 'Composability', link: '/guide/composability' },
         { text: 'Cloud', link: '/guide/cloud' },
         { text: 'Libraries', link: '/guide/libraries' },
         { text: 'Testing', link: '/guide/testing' },
@@ -45,9 +46,6 @@ const sidebar = {
  * you have any questions, feel free to reach out via Discord or GitHub Discussions.
  */
 export default {
-  srcDir: p.projectPath('docs'),
-  outDir: p.projectStoragePath('app/docs'),
-  cacheDir: p.projectStoragePath('app/cache/docs'),
   lang: 'en-US',
   title: 'Stacks',
   description: 'Rapid application, cloud & library framework.',

docs/api.md

@@ -0,0 +1,42 @@
+# The Buddy CLI
+
+```bash
+# buddy make:component HelloWorld # bootstraps HelloWorld.vue component
+# buddy make:function hello-world # bootstraps hello-world.ts function
+# buddy make:stack hello-world # bootstraps component & function
+
+# buddy install # installs all deps
+# buddy update # updates the stack to the latest version
+# buddy clean # cleans all deps & dist folders
+# buddy fresh # cleans & reinstalls all deps
+
+# buddy dev # stubs everything & and starts smart dev server
+# buddy dev:components # stubs components
+# buddy dev:web-components # stubs components
+# buddy dev:docs # starts docs dev server & opens docs in browser
+
+# buddy build # runs typecheck & builds the project
+# buddy build:components # builds component library
+# buddy build:functions # builds function library
+# buddy build:web-components # builds web components/custom elements library
+# buddy build:docs # builds the docs
+
+# buddy deploy:functions # zero-config: Netlify, Vercel, AWS, Cloudflare (and more)
+# buddy deploy:docs # zero-config: Netlify & Vercel
+
+# buddy commit # Be a good commitizen. GUI for git commits.
+# buddy release # GUI for releasing the libraries & triggers npm releases
+# buddy changelog # automatically generates changelog
+
+# buddy lint # lints the codebase
+# buddy lint:fix # auto-fixes lint errors
+# buddy test:types # runs typecheck
+# buddy types:fix # wip
+
+# buddy test # runs whole test suite
+# buddy test:e2e # runs e2e tests
+# buddy test:unit # runs unit tests
+# buddy test:coverage # runs test coverage
+
+# buddy example # run an example script (follow prompts)
+```

docs/guide/buddy.md

@@ -2,7 +2,7 @@
 
 What is the Composability-First Design pattern? Also known as "Atomic-First Design," read along for an explanation and to learn more about how these design principles to improve your development experience (DX).
 
-![Atomic UI & FX Design](./images/diagram.png)
+![Atomic UI & FX Design](../images/diagram.png)
 
 ## The Why