Skip to content

feat(web): add nextra docs site with full documentation and github pages deployment#503

Open
arielshad wants to merge 8 commits intomainfrom
feat/nextra-docs-site
Open

feat(web): add nextra docs site with full documentation and github pages deployment#503
arielshad wants to merge 8 commits intomainfrom
feat/nextra-docs-site

Conversation

@arielshad
Copy link
Copy Markdown
Contributor

Summary

  • Add a complete Nextra-powered documentation site (packages/docs-site/) with 42 pages covering architecture, CLI, concepts, development guides, API references, and web UI documentation
  • Configure GitHub Pages deployment workflow (.github/workflows/docs.yml) for automatic publishing on push to main
  • Integrate the docs site into the pnpm workspace with proper next.config.mjs, tsconfig.json, and MDX support
  • Add comprehensive navigation structure with sidebar, search, breadcrumbs, and table of contents

Evidence

Homepage

Homepage

Getting Started

Getting Started

Architecture Documentation

Architecture

CLI Section

CLI

Concepts Section

Concepts

Development Documentation

Development

Guides Section

Guides

Verification

  • All 372 test files passing (5,267 tests)
  • CLI build compiles successfully
  • Nextra docs site builds and exports all 42 pages
  • Lint passes cleanly

Test plan

  • Unit tests pass (5,267 tests across 372 files)
  • CLI build succeeds (pnpm build)
  • Docs site static export generates all pages
  • Lint passes with zero errors
  • CI pipeline passes on PR

Built with Shep 🐑 Shep Bot

arielshad and others added 8 commits April 1, 2026 15:54
Create a Nextra 4-based documentation site under packages/docs-site
that mirrors all existing docs/ content as a static site deployable
to GitHub Pages. Includes sidebar navigation, docs theme, and a
GitHub Actions workflow for automatic deployment on push to main.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 1, 2026

Dev Release Published

Artifact Version Install
npm 1.161.0-pr503.ee26ef9 npm install -g @shepai/cli@1.161.0-pr503.ee26ef9

Published from commit fcdf573 | View CI

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