Add public Starlight docs site

Adds a public documentation mirror under project-docs, Starlight/Astro site content, sync and generation scripts, GitHub Pages deployment workflow, and public-safe ignore rules.

Author: mrfloris

.github/workflows/deploy.yml

@@ -0,0 +1,38 @@
+name: Deploy to GitHub Pages
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+
+      - name: Install, build, and upload site
+        uses: withastro/action@v6
+        with:
+          node-version: 24
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5

.gitignore

@@ -0,0 +1,23 @@
+.DS_Store
+.env
+.env.*
+!.env.example
+
+node_modules/
+dist/
+.astro/
+.cache/
+
+*.log
+*.tmp
+*.sqlite
+*.sqlite3
+*.db
+
+*.jar
+*.war
+*.zip
+
+servers/
+build/
+out/

README.md

@@ -0,0 +1,46 @@
+# 1MoreBlock Plugin Docs
+
+Public documentation mirror and Starlight site for 1MoreBlock plugin features.
+
+The private development repository is `mrfdev/1MB-CMIAPI`. This public repository intentionally publishes documentation only:
+
+- `project-docs/README.md`
+- `project-docs/docs/`
+- `src/content/docs/` for the Starlight site
+
+It does not publish plugin source code, built jars, private server folders, databases, paid plugin files, internal task logs, or operational checklists.
+
+## Local Workflow
+
+From this repository:
+
+```bash
+npm install
+npm run docs:sync
+npm run build
+```
+
+`npm run docs:sync` copies `README.md` and `docs/` from the sibling private repo at `../CMI-API` into `project-docs/`, then regenerates the Starlight content pages.
+
+If the private repo lives somewhere else:
+
+```bash
+PRIVATE_DOCS_SOURCE=/path/to/CMI-API npm run docs:sync
+```
+
+## GitHub Pages
+
+GitHub Actions deploys the Starlight build on pushes to `main`.
+
+Default public URL:
+
+```text
+https://mrfdev.github.io/1MB-Plugins-Docs/
+```
+
+For a future custom domain such as `docs.1moreblock.com`, add `public/CNAME` and update `astro.config.mjs` according to the Astro GitHub Pages custom-domain instructions.
+
+## Sources
+
+- Starlight: https://starlight.astro.build/
+- Astro GitHub Pages deployment: https://docs.astro.build/en/guides/deploy/github/

astro.config.mjs

@@ -0,0 +1,42 @@
+import { defineConfig } from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+export default defineConfig({
+  site: 'https://mrfdev.github.io',
+  base: '/1MB-Plugins-Docs',
+  integrations: [
+    starlight({
+      title: '1MoreBlock Plugin Docs',
+      description: 'Friendly public documentation for 1MoreBlock plugin features.',
+      editLink: {
+        baseUrl: 'https://github.com/mrfdev/1MB-Plugins-Docs/edit/main/',
+      },
+      social: [
+        {
+          icon: 'github',
+          label: 'GitHub',
+          href: 'https://github.com/mrfdev/1MB-Plugins-Docs',
+        },
+      ],
+      customCss: ['./src/styles/custom.css'],
+      sidebar: [
+        { label: 'Home', link: '/' },
+        {
+          label: 'Players',
+          items: [
+            { slug: 'player-guides/getting-started' },
+            { slug: 'player-guides/commands' },
+            { slug: 'player-guides/features' },
+          ],
+        },
+        {
+          label: 'Staff Reference',
+          items: [
+            { slug: 'staff-reference' },
+            { slug: 'staff-reference/plugins' },
+          ],
+        },
+      ],
+    }),
+  ],
+});