docs: deploy OSS docs to mozilla-ai.github.io/clawbolt#949
Draft
docs: deploy OSS docs to mozilla-ai.github.io/clawbolt#949
Conversation
Splits docs hosting so that clawbolt.ai is freed up for the premium app. The OSS docs now live at the default GitHub Pages project URL (mozilla-ai.github.io/clawbolt) instead of using the clawbolt.ai custom domain. Changes: - Delete docs/public/CNAME so GitHub Pages stops serving at clawbolt.ai - Update astro.config.mjs site/base for project site URL - Convert absolute Markdown links in content to relative paths. Starlight auto-prefixes the base path on sidebar/nav links but not on raw Markdown links in content, so absolute links like [Memory](/guide/memory/) would break under the new /clawbolt base. - Update getDocsUrl() in OSS frontend to point at the new docs URL After merge, the clawbolt.ai DNS / GitHub Pages custom domain config should be cleared so the domain can be repointed to Railway for the premium app. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Splits docs hosting so that
clawbolt.aiis freed up for the premium app on Railway. The OSS docs now live at the default GitHub Pages project URL (mozilla-ai.github.io/clawbolt) instead of using theclawbolt.aicustom domain.This is one of two related PRs:
clawbolt.aito GitHub Pages default URL.clawbolt.ai/docs/.Why
Premium currently links to
clawbolt.ai/guide/for help docs, butclawbolt.aiis just the OSS docs site. The OSS docs update independently of premium releases, creating a version-mismatch risk where premium users see docs for features that may not be in their premium build. Splitting the deployment lets premium ship its own version-locked user docs while OSS retains the full developer-facing docs.Changes
docs/public/CNAMEso GitHub Pages stops serving atclawbolt.aiastro.config.mjssite/basefor project site URL (mozilla-ai.github.io+/clawbolt)[Memory](/guide/memory/)would 404 under the new/clawboltbase.getDocsUrl()in OSS frontend to point at the new docs URL.Post-merge
After merge, clear the
clawbolt.aicustom domain config in the GitHub Pages settings (or DNS provider) so the domain can be repointed to Railway for the premium app.Type
Checklist
CI=true npm run buildand verified all internal links resolve under/clawbolt/baseAI Usage