new site, new model hub, new website

Author: ramonpzg

.github/workflows/docs.yml

@@ -4,28 +4,33 @@ on:
   push:
     branches:
       - dev
+      - main
     paths:
       - 'docs/**'
+      - 'docs-astro/**'
       - '.github/workflows/docs.yml'
   pull_request:
     paths:
       - 'docs/**'
+      - 'docs-astro/**'
       - '.github/workflows/docs.yml'
-    # Review gh actions docs if you want to further define triggers, paths, etc
-    # https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#on
   schedule:
     - cron: "0 22 * * 1,2,3,4,5,6"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  deployments: write
+  pull-requests: write
+  pages: write
+  id-token: write
 
 jobs:
-  deploy:
-    name: Deploy to Cloudflare Pages
+  deploy-docusaurus:
+    name: Deploy Docusaurus to Cloudflare Pages
     env:
       CLOUDFLARE_PROJECT_NAME: cortex-docs
     runs-on: ubuntu-latest
-    permissions:
-      contents: write
-      deployments: write
-      pull-requests: write
     steps:
       - uses: actions/checkout@v3
       - uses: actions/setup-node@v3
@@ -72,15 +77,14 @@ jobs:
           accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
           projectName: ${{ env.CLOUDFLARE_PROJECT_NAME }}
           directory: ./docs/build
-          # Optional: Enable this if you want to have GitHub Deployments triggered
           gitHubToken: ${{ secrets.GITHUB_TOKEN }}
         id: deployCloudflarePages
 
       - uses: mshick/add-pr-comment@v2
         if: github.event_name == 'pull_request'
         with:
           message: |
-            Preview URL: ${{ steps.deployCloudflarePages.outputs.url }}
+            Docusaurus Preview URL: ${{ steps.deployCloudflarePages.outputs.url }}
 
       - name: Publish to Cloudflare Pages Production
         if: (github.event_name == 'push' || github.event_name == 'schedule') && github.ref == 'refs/heads/dev' && github.event.pull_request.head.repo.full_name != github.repository
@@ -91,5 +95,30 @@ jobs:
           projectName: ${{ env.CLOUDFLARE_PROJECT_NAME }}
           directory: ./docs/build
           branch: main
-          # Optional: Enable this if you want to have GitHub Deployments triggered
           gitHubToken: ${{ secrets.GITHUB_TOKEN }}
+
+  build-astro:
+    name: Build Astro Site
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+      - name: Install, build, and upload Astro site
+        uses: withastro/action@v3
+        with:
+          path: ./docs-astro
+          # node-version: 20 # Uncomment to specify Node version
+          # package-manager: pnpm@latest # Uncomment to specify package manager
+
+  deploy-astro:
+    name: Deploy Astro to GitHub Pages
+    needs: build-astro
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main'
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -29,3 +29,4 @@ docs/.yarn/
 docs/.yarnrc.yml
 docs/bun.lockb
 docs/yarn.lock
+archive/

docs/.env.example

@@ -1,22 +1,21 @@
-# Dependencies
-/node_modules
+# build output
+dist/
+# generated types
+.astro/
 
-# Production
-/build
-
-# Generated files
-.docusaurus
-.cache-loader
-
-# Misc
-.DS_Store
-.env.local
-.env.development.local
-.env.test.local
-.env.production.local
+# dependencies
+node_modules/
 
+# logs
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+pnpm-debug.log*
 
-.env
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store

docs/.gitignore

@@ -1,55 +1,54 @@
-# Website
+# Starlight Starter Kit: Basics
 
-This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
-
-### Installation
-
-```
-$ yarn
-```
-
-### Local Development
+[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
 
 ```
-$ yarn start
+bun create astro@latest -- --template starlight
 ```
 
-This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
-
-### Build
+[![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/starlight/tree/main/examples/basics)
+[![Open with CodeSandbox](https://assets.codesandbox.io/github/button-edit-lime.svg)](https://codesandbox.io/p/sandbox/github/withastro/starlight/tree/main/examples/basics)
+[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/withastro/starlight&create_from_path=examples/basics)
+[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fwithastro%2Fstarlight%2Ftree%2Fmain%2Fexamples%2Fbasics&project-name=my-starlight-docs&repository-name=my-starlight-docs)
 
-```
-$ yarn build
-```
-
-This command generates static content into the `build` directory and can be served using any static contents hosting service.
+> 🧑‍🚀 **Seasoned astronaut?** Delete this file. Have fun!
 
-### Deployment
+## 🚀 Project Structure
 
-Using SSH:
+Inside of your Astro + Starlight project, you'll see the following folders and files:
 
 ```
-$ USE_SSH=true yarn deploy
+.
+├── public/
+├── src/
+│   ├── assets/
+│   ├── content/
+│   │   ├── docs/
+│   └── content.config.ts
+├── astro.config.mjs
+├── package.json
+└── tsconfig.json
 ```
 
-Not using SSH:
+Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on its file name.
 
-```
-$ GIT_USER=<Your GitHub username> yarn deploy
-```
+Images can be added to `src/assets/` and embedded in Markdown with a relative link.
 
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
+Static assets, like favicons, can be placed in the `public/` directory.
 
-## Changelog Generator
+## 🧞 Commands
 
-To generate a changelog post, run:
+All commands are run from the root of the project, from a terminal:
 
-```bash
-  yarn create:changelog
-```
+| Command                   | Action                                           |
+| :------------------------ | :----------------------------------------------- |
+| `bun install`             | Installs dependencies                            |
+| `bun dev`             | Starts local dev server at `localhost:4321`      |
+| `bun build`           | Build your production site to `./dist/`          |
+| `bun preview`         | Preview your build locally, before deploying     |
+| `bun astro ...`       | Run CLI commands like `astro add`, `astro check` |
+| `bun astro -- --help` | Get help using the Astro CLI                     |
 
-- **Title & Slug**: Generate changelog post files with a title and a slug.
-- **Description**: Add a description for the changelog post.
-- **Version**: Add a version for the changelog post.
+## 👀 Want to learn more?
 
-The pages will be generated in `changelog/${slug}`. You can start writing your changelog post here.
+Check out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build), or jump into the [Astro Discord server](https://astro.build/chat).

docs/.prettierignore

@@ -0,0 +1,152 @@
+// @ts-check
+import { defineConfig } from "astro/config";
+import starlight from "@astrojs/starlight";
+import starlightUtils from "@lorenzo_lewis/starlight-utils";
+import starlightVideos from 'starlight-videos'
+
+
+// https://astro.build/config
+export default defineConfig({
+  site: 'https://cortex.so',
+  integrations: [
+    starlight({
+      title: "Cortex",
+      logo: { src: "./src/assets/logos/cortex.svg" },
+      favicon: "./src/assets/logos/cortex.svg",
+      social: {
+        github: "https://github.com/menloresearch/cortex.cpp",
+        discord: "https://discord.gg/FTk2MvZwJH",
+        "x.com": "https://x.com/cortex_so",
+        youtube: "https://www.youtube.com/@menloresearch",
+        linkedin: "https://www.linkedin.com/company/menloresearch/",
+      },
+      sidebar: [
+        {
+          label: "Title Bar",
+          items: [
+            { label: "Docs", link: "overview" },
+            { label: "Model Hub", link: "/model-hub" },
+          ],
+        },
+        { label: "Welcome", slug: "overview" },
+        {
+          label: "How-To",
+          items: [
+            { label: "Get Started", slug: "how-to/quickstart" },
+            { label: "Install Cortex", slug: "how-to/installation" },
+            { label: "Use Models", slug: "how-to/using-models" },
+            { label: "Troubleshoot", slug: "how-to/troubleshooting" },
+            { label: "Configuration", 
+              items: [
+                { label: "Overview", slug: "how-to/configurations" },
+                { label: "CORS", slug: "how-to/configurations/cors" },
+                { label: "Proxy", slug: "how-to/configurations/proxy" },
+                { label: "Token", slug: "how-to/configurations/token" },
+              ],
+            },
+          ],
+        },
+        {
+          label: "Explanation",
+          items: [
+            { label: "Architecture", 
+              items: [
+                // { label: "Overview", slug: "explanation/architecture" },
+                { label: "Cortex DB", slug: "explanation/architecture/cortex-db" },
+                { label: ".cortexrc", slug: "explanation/architecture/cortexrc" },
+                { label: "Data Folder", slug: "explanation/architecture/data-folder" },
+                { label: "Updater", slug: "explanation/architecture/updater" },
+              ],
+            },
+            {
+              label: "Models",
+              items: [
+                { label: "Overview", slug: "explanation/models" },
+                { label: "Model YAML", slug: "explanation/models/model-yaml" }
+                // { label: "Hardware", slug: "capabilities/hardware" },
+              ],
+            },
+            {
+              label: "Engines",
+              items: [
+                { label: "Overview", slug: "explanation/models" },
+                { label: "Model YAML", slug: "explanation/models/model-yaml" }
+                // { label: "Hardware", slug: "capabilities/hardware" },
+              ],
+            },
+          ],
+        },
+        {
+          label: "Tutorials",
+          items: [
+            { label: "Function Calling", slug: "tutorials/function-calling" },
+            { label: "Structured Outputs", slug: "tutorials/structured-outputs" },
+          ],
+        },
+        {
+          label: "Reference",
+          items: [
+          {
+            label: "CLI",
+            collapsed: true,
+            items: [
+              { label: "cortex", slug: "reference/cli" },
+              { label: "cortex start", slug: "reference/cli/start" },
+              { label: "cortex run", slug: "reference/cli/run" },
+              { label: "cortex config", slug: "reference/cli/config" },
+              { label: "cortex pull", slug: "reference/cli/pull" },
+              { label: "cortex stop", slug: "reference/cli/stop" },
+              { label: "cortex ps", slug: "reference/cli/ps" },
+              { label: "cortex serve", slug: "reference/cli/serve" },
+              { label: "cortex update", slug: "reference/cli/update" },
+              { label: "cortex hardware", slug: "reference/cli/hardware" },
+            ]
+          },
+          {
+            label: "Models",
+            collapsed: true,
+            items: [
+              { label: "Overview", slug: "reference/cli/models" },
+              { label: "cortex models list", slug: "reference/cli/models/list" },
+              { label: "cortex models get", slug: "reference/cli/models/get" },
+              { label: "cortex models pull", slug: "reference/cli/models/pull" },
+              { label: "cortex models start", slug: "reference/cli/models/start" },
+              { label: "cortex models stop", slug: "reference/cli/models/stop" },
+              { label: "cortex models update", slug: "reference/cli/models/update" },
+              { label: "Remove", slug: "reference/cli/models/remove" },
+            ],
+          },
+            {
+              label: "Configs",
+              collapsed: true,
+              items: [
+                { label: "Overview", slug: "reference/cli/configs" },
+                { label: "List", slug: "reference/cli/configs/list" },
+                { label: "Get", slug: "reference/cli/configs/get" },
+                { label: "Set", slug: "reference/cli/configs/set" },
+              ],
+            },
+            {
+              label: "Engines",
+              collapsed: true,
+              items: [
+                { label: "Overview", slug: "reference/cli/engines" },
+                { label: "List", slug: "reference/cli/engines/list" },
+                { label: "Get", slug: "reference/cli/engines/get" },
+                { label: "Init", slug: "reference/cli/engines/init" },
+              ],
+            },
+          ],
+        },
+      ],
+      plugins: [
+        starlightUtils({
+          navLinks: {
+            leading: { useSidebarLabelled: "Title Bar" },
+          },
+        }),
+        starlightVideos(),
+      ],
+    }),
+  ],
+});