ReviewOS

also looking at this

loghqorg/loghq

Add BunPress guide and pre-E2E quality gates

#4
Merged glennmichael123 wants to merge docs/bunpress-product-guide into main
246 files +1744 -64381
config/cloud.tsmodified+14-6
Changes to config/cloud.ts
@@ -721,23 +721,22 @@ export const tsCloud: TsCloudConfig = {
721721 * to `/var/www/<siteName>`, served by the reverse proxy's `file_server`)
722722 * - `bucket` → upload built `root` to object storage + CDN
723723 *
724 * The static sites below (`docs`, `blog`, and external marketing sites) are the Hetzner
724 * Static sites such as `docs` are the Hetzner
725725 * server-static replacement for the AWS website-hosting buckets in
726726 * `infrastructure.storage` (see the supersede note there). `buddy deploy`'s
727727 * Hetzner path (`deployAllComputeSites`) builds each site's `root`, tars it,
728728 * and ships it to `/var/www/<siteName>` on the box. No new Hetzner buckets are
729729 * created. Each site's key maps 1:1 to `/var/www/<key>`:
730 * - `docs` → /var/www/docs → served at /docs on stacksjs.com
731 * - `blog` → /var/www/blog → served at /blog on stacksjs.com
730 * - `docs` -> /var/www/docs -> served at /docs on loghq.org
732731 *
733732 * The Stacks root is served by the `main` server app; do not add a second
734 * static `/` site for stacksjs.com or it will compete with the app route.
733 * static `/` site for loghq.org or it will compete with the app route.
735734 */
736735 sites: {
737736 // The loghq app — a Bun server (`buddy serve`) rendering the stx issues
738737 // dashboard + serving the /errors ingest + /api issue routes on :3000,
739 // fronted by the reverse proxy on loghq.org. Single-purpose error-tracking
740 // app: no docs/blog/marketing static sites from the scaffold template.
738 // fronted by the reverse proxy on loghq.org, with BunPress documentation
739 // mounted separately at /docs.
741740 //
742741 // On the shared `stacks` box (attachTo) ts-cloud namespaces every install
743742 // dir by project slug — this ships to /var/www/loghq-main via the
@@ -821,6 +820,15 @@ export const tsCloud: TsCloudConfig = {
821820 env: { HOST: '127.0.0.1' },
822821 },
823822
823 // BunPress documentation, built as static files and mounted under /docs.
824 docs: {
825 root: './dist/docs/.bunpress',
826 path: '/docs',
827 domain: env.APP_DOMAIN || 'loghq.org',
828 deploy: 'server',
829 build: 'PATH="$PWD/node_modules/.bin:$PATH" bun node_modules/@stacksjs/buddy/dist/cli.js build docs && test -d dist/docs/.bunpress',
830 },
831
824832 // www → apex redirect.
825833 www: { domain: `www.${env.APP_DOMAIN || 'loghq.org'}`, redirect: `https://${env.APP_DOMAIN || 'loghq.org'}` },
826834 },