Skip to content

feat(docs): starlight migration#711

Open
lempira wants to merge 21 commits intodecouplingfrom
docs/starlight-migration
Open

feat(docs): starlight migration#711
lempira wants to merge 21 commits intodecouplingfrom
docs/starlight-migration

Conversation

@lempira
Copy link
Contributor

@lempira lempira commented Feb 26, 2026

This PR migrates the algokit-cli documentation from 44 markdown files served directly from GitHub to an Astro Starlight site deployed to GitHub Pages at algorandfoundation.github.io/algokit-cli/, bringing it in line with algokit-utils-py and algokit-subscriber-py.

The migration covers the full stack: Starlight scaffold with sidebar navigation, a splash home page, content migration of all hand-written docs (features, tutorials, concepts, ADRs), and a cli_build.py script that runs sphinx-click to auto-generate the CLI reference page. CI is updated with a check-docs workflow that validates the build on every PR, and a deploy-docs job in cd.yaml that publishes to GitHub Pages on merge to main.

The sphinx/sphinx-click setup is preserved unchanged — only the output destination and post-processing change. Sphinx deps are moved from the dev group to a dedicated docs group (poetry install --with docs) so they don't bloat the default dev install.

Doc Preview

image

aorumbayev and others added 20 commits December 16, 2025 19:59
Added PyInstaller hidden imports for:
- algokit_abi, algokit_indexer_client, algokit_kmd_client (standalone packages)
- algokit_utils.algo25, algokit_utils.transact, algokit_utils.common, algokit_utils.clients (proxy modules that re-export from standalone packages)

This fixes 'No module named algokit_utils.algo25' error in portability tests.
The portability tests were inadvertently using the venv-installed algokit
instead of the PyInstaller binary because 'poetry run' prepends .venv/bin
to PATH, causing 'algokit' to resolve to the venv version.

- Add _get_algokit_binary() to explicitly find the PyInstaller binary in dist/
- Support PYINSTALLER_BINARY_PATH env var for explicit binary path
- Filter out .venv/bin (or .venv/Scripts on Windows) from PATH fallback
- Add Windows compatibility with os.pathsep and .exe extension
- Remove unused command_str_to_list function
Bootstrap Astro Starlight using the official template. Adds package.json,
tsconfig.json, content.config.ts, and .gitignore for the docs site.
Includes remark-github-alerts for callout box support and the AlgoKit
favicon.
Configure Starlight for algorandfoundation.github.io/algokit-cli/ with
full sidebar structure covering tutorials, features, concepts, architecture
decisions, and auto-generated CLI reference. Adds cli-reference.css for
sphinx-click output styling.
Move all 44 docs pages into docs/src/content/docs/ with Starlight
frontmatter, correct absolute internal links, and updated image paths.
Copy all image assets to docs/public/images/. Build produces 46 pages
cleanly.
@lempira lempira changed the base branch from main to decoupling February 26, 2026 21:42
@lempira lempira force-pushed the docs/starlight-migration branch from 936451a to 26fb7dd Compare February 26, 2026 21:54
@lempira lempira requested a review from aorumbayev February 26, 2026 22:12
@lempira lempira changed the title Docs/starlight migration feat(docs): starlight migration Feb 26, 2026
@aorumbayev aorumbayev force-pushed the decoupling branch 2 times, most recently from 9d0faf4 to c0267c3 Compare March 3, 2026 14:24
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.

3 participants