Initial Commit

Author: FL4TLiN3

.github/workflows/ci.yml

@@ -0,0 +1,106 @@
+# .github/workflows/ci.yml
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+env:
+  CI: 'true'
+
+jobs:
+  install:
+    name: Install (pnpm fetch/offline)
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'pnpm'
+      - name: Enable Corepack (pnpm)
+        run: corepack enable
+      - name: pnpm fetch
+        run: pnpm fetch
+      - name: pnpm install --offline
+        run: pnpm install --offline --frozen-lockfile
+      - name: Restore turbo cache
+        uses: actions/cache@v4
+        with:
+          path: .turbo
+          key: turbo-${{ runner.os }}-${{ hashFiles('**/*.[tj]s', '**/*.[tj]sx', 'pnpm-lock.yaml') }}
+          restore-keys: |
+            turbo-${{ runner.os }}-
+
+  quality:
+    name: Lint / Typecheck / Knip
+    needs: install
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'pnpm'
+      - name: Enable Corepack
+        run: corepack enable
+      - name: pnpm install --offline
+        run: pnpm install --offline --frozen-lockfile
+
+      - name: Lint & Format check (biome)
+        run: pnpm run format-and-lint
+
+      - name: Unused deps check (knip)
+        run: pnpm run check-deps
+
+  test:
+    name: Test (vitest + coverage)
+    needs: install
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'pnpm'
+      - name: Enable Corepack
+        run: corepack enable
+      - name: pnpm install --offline
+        run: pnpm install --offline --frozen-lockfile
+      - name: Prepare test env
+        run: pnpm run reset
+      - name: Run tests
+        run: pnpm test --coverage --coverage-reporter=lcov --coverage-dir=./coverage apps/ packages/
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage/lcov.info
+
+  build:
+    name: Build (turbo)
+    needs: [quality, test]
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'pnpm'
+      - name: Enable Corepack
+        run: corepack enable
+      - name: pnpm install --offline
+        run: pnpm install --offline --frozen-lockfile
+      - name: Restore turbo cache
+        uses: actions/cache@v4
+        with:
+          path: .turbo
+          key: turbo-${{ runner.os }}-${{ hashFiles('**/*.[tj]s', '**/*.[tj]sx', 'pnpm-lock.yaml') }}
+          restore-keys: |
+            turbo-${{ runner.os }}-
+      - name: Build
+        run: pnpm run build

.gitignore

@@ -24,4 +24,4 @@ perstack.toml
 test-e2e/perstack/
 Thumbs.db
 yarn-debug.log*
-yarn-error.log*
+yarn-error.log*

docs/content/get-started/_meta.tsx

@@ -13,12 +13,7 @@ const meta: MetaRecord = {
       timestamp: false,
     },
   },
-  tutorial: {
-    title: "Tutorial",
-    theme: {
-      timestamp: false,
-    },
-  },
+  tutorials: "Tutorials",
   "expert-stack": {
     title: "Expert Stack",
     theme: {

docs/content/get-started/tutorial.mdx

@@ -0,0 +1,18 @@
+import type { MetaRecord } from "nextra"
+
+const meta: MetaRecord = {
+  "building-experts": {
+    title: "Building Experts",
+    theme: {
+      timestamp: false,
+    },
+  },
+  "using-experts": {
+    title: "Using Experts",
+    theme: {
+      timestamp: false,
+    },
+  },
+}
+
+export default meta