Skip to content

feat: deploy docs to org-level GitHub Pages#4

Open
barontechIO wants to merge 5 commits into
mainfrom
feat/org-pages-deploy
Open

feat: deploy docs to org-level GitHub Pages#4
barontechIO wants to merge 5 commits into
mainfrom
feat/org-pages-deploy

Conversation

@barontechIO
Copy link
Copy Markdown
Contributor

Summary

  • Migrate docs deployment from nekte-protocol.github.io/nekte/ to nekte-protocol.github.io (org-level pages)
  • Remove base: '/nekte' from Astro config — no subpath needed at root
  • Deploy workflow now pushes built site to nekte-protocol/nekte-protocol.github.io repo
  • Simplify landing page base URL handling

Setup required

  1. Create a Personal Access Token (or fine-grained token) with repo scope
  2. Add it as a repository secret named PAGES_DEPLOY_TOKEN in nekte-protocol/nekte → Settings → Secrets
  3. Enable GitHub Pages in nekte-protocol/nekte-protocol.github.io → Settings → Pages → Source: "Deploy from a branch" → Branch: main
  4. Merge this PR

Test plan

  • Verify PAGES_DEPLOY_TOKEN secret is configured
  • After merge, check https://nekte-protocol.github.io loads with full Starlight theme
  • All nav links resolve correctly (no /nekte/ prefix)

🤖 Generated with Claude Code

barontechIO and others added 5 commits April 8, 2026 17:16
- Remove base: '/nekte' from Astro config (no longer needed at root)
- Update deploy workflow to push to nekte-protocol.github.io repo
- Simplify landing page base URL handling
- Site will be served at https://nekte-protocol.github.io

Requires PAGES_DEPLOY_TOKEN secret with repo scope for cross-repo push.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Instead of cross-repo git push (requires broad PAT), trigger
nekte-protocol.github.io deploy workflow via API dispatch.
Requires PAGES_DEPLOY_TOKEN with actions:write on target repo only.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Deploy is now fully self-contained in nekte-protocol.github.io:
- clones nekte (public repo, no auth)
- deploys with its own GITHUB_TOKEN
- runs daily at 4am UTC + manual workflow_dispatch

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Remove website/ from monorepo (now lives in nekte-protocol/nekte-protocol.github.io)
- Remove website from pnpm workspace
- Simplify deploy-docs.yml (deploy managed by the pages repo itself)
- Site auto-deploys on every push to nekte-protocol.github.io main

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant