Squad/docs astro rewrite#293
Merged
bradygaster merged 15 commits intobradygaster:mainfrom Mar 9, 2026
Merged
Conversation
Contributor
IEvangelist
commented
Mar 9, 2026
IEvangelist
commented
Replace the custom Node.js static site generator (build.js + markdown-it) with a modern Astro 5 site using Tailwind CSS v4. Changes: - New Astro project in docs/ with content collections for docs and blog - Modern landing page with hero, feature grid, code example, and CTAs - Responsive sidebar navigation with dark/light theme toggle - All 82 doc pages and 29 blog posts preserved and migrated - Shiki syntax highlighting replaces highlight.js - Internal docs (specs, proposals, audits) moved to docs/_internal/ - Updated GitHub Actions workflow for Astro builds - Updated docs-build.test.ts for new Astro build system (20 tests passing) - Root package.json docs scripts updated (docs:build, docs:dev, docs:preview) Tech stack: Astro 5, Tailwind CSS 4, Shiki, GitHub Pages Build: 114 pages in ~2.5s Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Add remark plugin to rewrite .md links to Astro routes at build time - Fix base path (trailing slash) so all /squad/ URLs resolve correctly - Redirect deleted section links (cli/, sdk/) to reference/ pages - Convert repo-root file links (CHANGELOG, README) to GitHub URLs - Fix broken links: remote-squad-mode, cookbook/migration, upgrading, scaling-workstreams specs, sdk-first-mode tools-and-hooks - Update sharp to v0.34.x, add unist-util-visit dependency - Full link check: 112/112 internal links pass, 0 broken Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…ents - Add Pagefind full-text search (⌘K / Ctrl+K) with modal UI in header - Index 111 doc + blog pages (6,878 words) scoped via data-pagefind-body - Make sidebar scroll independently with sticky positioning on desktop - Update CI/CD: npm run build (chains astro build + pagefind), npm cache - All 5 workflow files updated with cache + correct build command - Add 2 new tests: pagefind index generation, search UI in header - 22/22 tests passing Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Add staggered CSS entrance animations to landing page hero section (badge → heading → description → CTAs → terminal, 100-700ms delays) - Animations use cubic-bezier easing for smooth settle-into-place feel - Respect prefers-reduced-motion: disable all animations for accessibility - Add mobile nav dropdown menu for non-docs pages (landing, blog) - On docs pages, hamburger opens the sidebar overlay as before - Make search button icon-only on mobile (sm:min-w instead of min-w) - Hide GitHub icon button on small screens (visible in mobile nav) - Responsive terminal section: smaller text/padding on mobile - All 22 tests passing Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Full-viewport hero with animated gradient mesh (floating glow orbs, subtle grid pattern, glassmorphic badge) - Split layout: text left, terminal demo right (side-by-side on desktop) - Terminal demo with staggered agent-line animations + activity indicator - Inline install snippet with copy-to-clipboard button - Social proof stats bar (19+ agents, 5 parallel streams, <60s setup, MIT) - New 'How it works' section: 3-step Install → Init → Ship flow - Dramatic gradient CTA section with grid overlay - Feature cards with gradient icon backgrounds and lift-on-hover - Docs cards with gradient backgrounds and chevron arrows - All animations respect prefers-reduced-motion - 22/22 tests passing, 0 broken links Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Thin scrollbar with squad-200/surface-700 thumb, rounded pill shape, transparent track. Uses both scrollbar-width/color (Firefox) and ::-webkit-scrollbar (Chrome/Safari/Edge). Applied globally to all scrollable areas (main, sidebar, code blocks, search results). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Remove overflow-y-auto and height constraint from <main>, letting the document scroll naturally (single page scrollbar). Sidebar remains sticky with its own independent overflow-y-auto. Search modal keeps its overflow for the results pane. Net result: max 1 page scrollbar + 1 sidebar scrollbar (only when sidebar content overflows). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Replace generic indigo palette with three color scales extracted from the Squad logo: - squad (primary): hot pink/rose #F05080 — buttons, links, active states - navy (secondary): dark blue #24365E — CTA backgrounds, feature icons, grid overlays - accent (cyan): teal #18B1C9 — feature icons, glow accents, hover states Each scale has 50–950 shades. Feature cards now alternate between all three palettes. Hero glow orbs use pink + cyan + navy. CTA section uses deep navy gradient. Scrollbar thumbs use squad-200/navy-800. All existing squad-* references automatically pick up the new pink. 22/22 tests passing, build clean. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Each card now has a unique top accent bar and hover color: - Get Started: squad pink gradient - Features: accent cyan gradient - Reference: navy blue gradient - Scenarios: tri-color gradient (pink → cyan → navy) Replaced washed-out pink gradient backgrounds with clean white/dark cards + colored top border accent. Hover states match each card's palette (border, shadow, text, chevron). Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Owner
I do adore you. |
This was referenced Mar 9, 2026
bradygaster
added a commit
that referenced
this pull request
Mar 9, 2026
…post - Port @diberry's installation decision tree (PR #288) and .squad/ explainer (PR #290) into Astro docs - Apply Brady's review fixes: sidebar scroll-to-active, CLI text updates, logo fix, Copilot CLI callouts, CI/CD cron safety warning - Update CONTRIBUTORS.md with @IEvangelist (Astro docs rewrite) and @diberry (4 PRs) - Add blog post 028: New Docs Site — Built by the Community Merges community work from: - PR #293 by @IEvangelist (Astro docs rewrite) - PR #286, #288, #290, #292 by @diberry (docs improvements) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Contributor
Author
|
I'll have a fast follow PR. I see now that it's deployed that the logo didn't come through. And I want to tweak one other minor thing. |
bradygaster
added a commit
that referenced
this pull request
Mar 9, 2026
- Add David Pine (@IEvangelist) to Code Contributors — PRs #293, #298 - Add Dina Berry (@diberry) to Code Contributors — PRs #286, #288, #290, #292 - Update Tamir Dresher with recent PRs #278-280, #283 - Add Dale Kirby to Code Contributors — PR #243 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
bradygaster
added a commit
that referenced
this pull request
Mar 9, 2026
* docs(ai-team): session log and orchestration records Session: 2026-03-09-docs-push-contributors Requested by: Brady Changes: - Logged PAO orchestration: blog 028 update, CONTRIBUTORS.md refresh - Logged FIDO orchestration: test baseline verification (22 passing) - Logged session summary: docs push workflow with PR #300 merge - No decisions inbox entries to merge * docs: credit Pine, Dina, Tamir, Kirby on docs contributor page - Add David Pine (@IEvangelist) to Code Contributors — PRs #293, #298 - Add Dina Berry (@diberry) to Code Contributors — PRs #286, #288, #290, #292 - Update Tamir Dresher with recent PRs #278-280, #283 - Add Dale Kirby to Code Contributors — PR #243 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
diberry
pushed a commit
to diberry/squad
that referenced
this pull request
Mar 10, 2026
…gaster#307) * docs(ai-team): session log and orchestration records Session: 2026-03-09-docs-push-contributors Requested by: Brady Changes: - Logged PAO orchestration: blog 028 update, CONTRIBUTORS.md refresh - Logged FIDO orchestration: test baseline verification (22 passing) - Logged session summary: docs push workflow with PR bradygaster#300 merge - No decisions inbox entries to merge * docs: credit Pine, Dina, Tamir, Kirby on docs contributor page - Add David Pine (@IEvangelist) to Code Contributors — PRs bradygaster#293, bradygaster#298 - Add Dina Berry (@diberry) to Code Contributors — PRs bradygaster#286, bradygaster#288, bradygaster#290, bradygaster#292 - Update Tamir Dresher with recent PRs bradygaster#278-280, bradygaster#283 - Add Dale Kirby to Code Contributors — PR bradygaster#243 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.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
2 participants
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.