docs: add comprehensive webdocs documentation

- Add getting-started, concepts, guides, recipes, and reference sections
- Update site configuration and branding
- Remove placeholder examples from core package

Author: andrewmelchor

.github/dependabot.yml

@@ -11,9 +11,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: oven-sh/setup-bun@v1
+      - uses: oven-sh/setup-bun@v2
         with:
-          bun-version: latest
+          bun-version-file: package.json
 
       - name: Install dependencies
         run: bun install --frozen-lockfile

.github/workflows/ci.yml

@@ -20,9 +20,9 @@ jobs:
         uses: actions/checkout@v4
 
       - name: Setup Bun
-        uses: oven-sh/setup-bun@v1
+        uses: oven-sh/setup-bun@v2
         with:
-          bun-version: latest
+          bun-version-file: package.json
 
       - name: Install dependencies
         run: bun install --frozen-lockfile

.github/workflows/codeql.yml

@@ -58,6 +58,7 @@ const { token } = await response.json();
 t-req/
 ├── apps/
 │   └── webdocs/       # Documentation site
+├── examples/          # Usage examples
 ├── packages/
 │   └── core/          # @t-req/core - HTTP parsing & execution
 ├── .changeset/        # Changesets for versioning

.github/workflows/release.yml

@@ -1,26 +1,84 @@
 // @ts-check
-import { defineConfig } from 'astro/config';
-import starlight from '@astrojs/starlight';
+import { defineConfig } from "astro/config";
+import starlight from "@astrojs/starlight";
+import tailwindcss from "@tailwindcss/vite";
 
 // https://astro.build/config
 export default defineConfig({
-	integrations: [
-		starlight({
-			title: 'My Docs',
-			social: [{ icon: 'github', label: 'GitHub', href: 'https://github.com/withastro/starlight' }],
-			sidebar: [
-				{
-					label: 'Guides',
-					items: [
-						// Each item here is one entry in the navigation menu.
-						{ label: 'Example Guide', slug: 'guides/example' },
-					],
-				},
-				{
-					label: 'Reference',
-					autogenerate: { directory: 'reference' },
-				},
-			],
-		}),
-	],
+  vite: {
+    plugins: [tailwindcss()],
+  },
+  integrations: [
+    starlight({
+      title: "@t-req/core",
+      components: {
+        ThemeProvider: "./src/components/ForceLightTheme.astro",
+        ThemeSelect: "./src/components/ThemeSelect.astro",
+      },
+      social: [
+        {
+          icon: "github",
+          label: "GitHub",
+          href: "https://github.com/tensorix-labs/t-req/tree/main/packages/core",
+        },
+      ],
+      customCss: ["./src/styles/global.css", "./src/styles/custom.css"],
+      sidebar: [
+        {
+          label: "Getting Started",
+          items: [
+            { label: "Introduction", slug: "getting-started/introduction" },
+            { label: "Installation", slug: "getting-started/installation" },
+            { label: "Quick Start", slug: "getting-started/quick-start" },
+          ],
+        },
+        {
+          label: "Core Concepts",
+          items: [
+            { label: "Ecosystem", slug: "concepts/ecosystem" },
+            { label: ".http File Format", slug: "concepts/http-file-format" },
+            { label: "Variables", slug: "concepts/variables" },
+            { label: "Request Lifecycle", slug: "concepts/request-lifecycle" },
+            { label: "Runtime Adapters", slug: "concepts/runtime-adapters" },
+          ],
+        },
+        {
+          label: "Guides",
+          items: [
+            { label: "Authentication", slug: "guides/authentication" },
+            { label: "Cookies", slug: "guides/cookies" },
+            { label: "File Uploads", slug: "guides/file-uploads" },
+            { label: "Form Data", slug: "guides/form-data" },
+            { label: "Testing Workflows", slug: "guides/testing-workflows" },
+            { label: "Error Handling", slug: "guides/error-handling" },
+            { label: "Tauri Integration", slug: "guides/tauri-integration" },
+          ],
+        },
+        {
+          label: "API Reference",
+          items: [
+            { label: "Client", slug: "reference/client" },
+            { label: "Engine", slug: "reference/engine" },
+            { label: "Parser", slug: "reference/parser" },
+            { label: "Interpolation", slug: "reference/interpolation" },
+            { label: "Cookies", slug: "reference/cookies" },
+            { label: "Runtime", slug: "reference/runtime" },
+            { label: "Config", slug: "reference/config" },
+            { label: "Types", slug: "reference/types" },
+          ],
+        },
+        {
+          label: "Recipes",
+          items: [
+            { label: "Retry Logic", slug: "recipes/retry-logic" },
+            { label: "Parallel Requests", slug: "recipes/parallel-requests" },
+            {
+              label: "E-Commerce Checkout",
+              slug: "recipes/e-commerce-checkout",
+            },
+          ],
+        },
+      ],
+    }),
+  ],
 });

README.md

@@ -11,7 +11,10 @@
   },
   "dependencies": {
     "@astrojs/starlight": "^0.37.3",
+    "@t-req/ui": "workspace:*",
     "astro": "^5.6.1",
-    "sharp": "^0.34.2"
+    "sharp": "^0.34.2",
+    "tailwindcss": "^4.1.0",
+    "@tailwindcss/vite": "^4.1.0"
   }
 }