feat: 🎉 Add Mobile Menu Footer and Sidebar components for improved navigation

feat: 📚 Create content configuration for documentation collections

feat: 📖 Add API overview documentation with detailed endpoint descriptions

feat: 🏗️ Introduce architecture documentation outlining ByteBox structure

feat: 💾 Document backup and portability strategies for data safety

chore: 📝 Add changelog highlights for major ByteBox milestones

docs: 🌐 Create Cloudflare Pages deployment guide for documentation site

docs: 🤝 Add contributing guidelines for community involvement

docs: 🔑 Document core concepts of ByteBox data model and UX behavior

docs: 📊 Create data model documentation detailing entities and relationships

docs: 🛠️ Add developer guide for local development workflow and scripts

docs: 🐳 Document Docker deployment process for production setup

docs: 💻 Create Electron desktop app documentation for native experience

docs: 🚀 Add getting started guide for local setup of ByteBox

docs: 📄 Create index page for ByteBox documentation with navigation cards

docs: 🏃‍♂️ Document running ByteBox in different runtime modes

docs: 🎨 Add theming and appearance documentation for customization options

docs: 🛠️ Create troubleshooting guide for common issues and recovery steps

style: 🎨 Add custom styles for ByteBox documentation site

chore: 🔧 Add TypeScript configuration for strict type checking

chore: 🌍 Create Wrangler configuration for Cloudflare Pages deployment

Author: sizzlebop

.github/workflows/release.yml

@@ -2,6 +2,7 @@
 # Made with ❤️ by Pink Pixel
 #
 # Triggers on any tag that looks like a version: v2.4.0, v3.0.0-beta.1, etc.
+# Can also be triggered manually via workflow_dispatch.
 #
 # Produces:
 #   • Windows → NSIS installer (.exe) — built on windows-latest
@@ -18,6 +19,11 @@ on:
   push:
     tags:
       - "v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Release tag to upload to (e.g. v2.4.0)"
+        required: true
 
 permissions:
   contents: write # needed to upload release assets
@@ -28,6 +34,12 @@ jobs:
     name: Windows installer
     runs-on: windows-latest
 
+    # Use bash for all run steps — the npm scripts in package.json use
+    # Unix pipes (grep) that break under cmd.exe / PowerShell.
+    defaults:
+      run:
+        shell: bash
+
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -46,13 +58,18 @@ jobs:
           DATABASE_URL: "file:./dev.db"
         run: npx prisma generate
 
+      # Run next build directly instead of `npm run build` — the npm script
+      # pipes through `grep` which can fail on Windows even under bash.
+      # The env vars below replicate what scripts/next-with-env.cjs sets.
       - name: Build Next.js
         env:
           DATABASE_URL: "file:./dev.db"
           NEXT_TELEMETRY_DISABLED: "1"
           NODE_ENV: production
           PORT: "1334"
-        run: npm run build
+          BROWSERSLIST_IGNORE_OLD_DATA: "1"
+          BASELINE_BROWSER_MAPPING_IGNORE_OLD_DATA: "1"
+        run: npx next build
 
       - name: Compile Electron main process
         run: npm run electron:compile
@@ -65,6 +82,7 @@ jobs:
       - name: Upload to GitHub Release
         uses: softprops/action-gh-release@v2
         with:
+          tag_name: ${{ github.event_name == 'workflow_dispatch' && github.event.inputs.tag || github.ref_name }}
           files: release/**/*.exe
           fail_on_unmatched_files: true
         env:

.gitignore

@@ -51,4 +51,5 @@ glass_theming_guide.md
 # other
 buildsinfo.md
 R2.txt
-s3api.md
+s3api.md
+release copy.yml

website/.gitignore

@@ -0,0 +1,21 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store

website/README.md

@@ -0,0 +1,38 @@
+# ByteBox Documentation Site
+
+Starlight-powered documentation for ByteBox.
+
+## Local Development
+
+```bash
+npm install
+npm run dev
+```
+
+Dev server runs on `http://localhost:4321` by default.
+
+## Build
+
+```bash
+npm run build
+npm run preview
+```
+
+## Cloudflare Pages Deploy
+
+This project includes `wrangler.toml` and deploy scripts.
+
+```bash
+npx wrangler login
+npm run build
+npm run cf:deploy
+```
+
+## Key Files
+
+- `astro.config.mjs` - Starlight config, sidebar, component overrides
+- `src/content/docs/` - docs content (`.md` and `.mdx`)
+- `src/components/starlight/` - custom Sidebar/Footer/MobileMenuFooter overrides
+- `src/components/docs/Endpoint.astro` - API callout block component
+- `src/styles/bytebox-docs.css` - ByteBox-themed visual layer
+- `wrangler.toml` - Cloudflare Pages config

website/astro.config.mjs

@@ -0,0 +1,58 @@
+// @ts-check
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+// https://astro.build/config
+export default defineConfig({
+	integrations: [
+		starlight({
+			title: 'ByteBox Docs',
+			description: 'Official documentation for ByteBox: setup, operation, concepts, and API behavior.',
+			logo: {
+				src: './src/assets/logo_banner.png',
+				alt: 'ByteBox',
+				replacesTitle: true,
+			},
+			favicon: '/favicon.png',
+			customCss: ['./src/styles/bytebox-docs.css'],
+			social: [{ icon: 'github', label: 'GitHub', href: 'https://github.com/pinkpixel-dev/bytebox' }],
+			components: {
+				Sidebar: './src/components/starlight/Sidebar.astro',
+				Footer: './src/components/starlight/Footer.astro',
+				MobileMenuFooter: './src/components/starlight/MobileMenuFooter.astro',
+			},
+			sidebar: [
+				{
+					label: 'Foundations',
+					items: [
+						{ label: 'Getting Started', slug: 'getting-started' },
+						{ label: 'Running ByteBox', slug: 'running-bytebox' },
+						{ label: 'Architecture', slug: 'architecture' },
+						{ label: 'Core Concepts', slug: 'core-concepts' },
+						{ label: 'Data Model', slug: 'data-model' },
+						{ label: 'Theming & Appearance', slug: 'theming-and-appearance' },
+					],
+				},
+				{
+					label: 'Integrations',
+					items: [
+						{ label: 'API Overview', slug: 'api-overview' },
+						{ label: 'Backup & Portability', slug: 'backup-and-portability' },
+						{ label: 'Docker Deployment', slug: 'docker-deployment' },
+						{ label: 'Electron Desktop', slug: 'electron-desktop' },
+						{ label: 'Cloudflare Pages', slug: 'cloudflare-pages' },
+					],
+				},
+				{
+					label: 'Development',
+					items: [
+						{ label: 'Developer Guide', slug: 'developer-guide' },
+						{ label: 'Contributing', slug: 'contributing' },
+						{ label: 'Troubleshooting', slug: 'troubleshooting' },
+						{ label: 'Changelog Highlights', slug: 'changelog' },
+					],
+				},
+			],
+		}),
+	],
+});