Skip to content

Re-platform both microsites onto the new aws website archetype#2

Merged
jeffreyaven merged 1 commit into
mainfrom
claude/anthropic-stackql-providers-m8s5mg
Jul 8, 2026
Merged

Re-platform both microsites onto the new aws website archetype#2
jeffreyaven merged 1 commit into
mainfrom
claude/anthropic-stackql-providers-m8s5mg

Conversation

@jeffreyaven

Copy link
Copy Markdown
Contributor

Applies the new microsite pattern from stackql-registry/stackql-provider-aws (stackql_aws_provider/website, stackql-provider branch) to both sites in this repo, per request — deployment vector notwithstanding (this repo stays on Netlify).

What changed (both sites)

  • Thin config + vendored shared config: docusaurus.config.js is now a small wrapper calling createConfig from ./.shared-config/index.js; stackql/docusaurus-config@main is shallow-cloned at build time via yarn vendor-config (wired as prestart/prebuild), and .shared-config/ is gitignored — never committed. provider.js carries the site identity (providerName/providerTitle), consumed by both the config and sidebars.js.
  • Docusaurus ^3.10.1 with @docusaurus/faster (future: {v4, faster}), plugin-ideal-image, theme-mermaid, and the archetype's overrides/resolutions block. One addition on top of the archetype: sharp pinned ^0.33 (plugin-ideal-image resolves sharp 0.32, whose GitHub-releases binary download fails in restricted environments; 0.33+ ships prebuilt npm packages).
  • src/static/theme assets replaced with the archetype's (registry-branded logo override, global.css, TSX footer theme, site.webmanifest, favicon set); the old databricks-derived src/pages/* redirect stubs are gone — the shared config's redirects plugin now provides /providers/*, /install, /blog, etc.
  • Monorepo fix: createConfig derives projectName/editUrl as stackql-provider-<name-sans-underscores> (→ stackql-provider-anthropicadmin), which is wrong for this two-provider repo. Both configs post-mutate projectName = 'stackql-provider-anthropic' and the per-site docs.editUrl. The slug-derived site URL (anthropic-admin-provider.stackql.io from anthropic_admin) is correct as-is.
  • Not carried over: static/CNAME and .nojekyll (GitHub Pages deployment artifacts); per-site netlify.toml retained.

Verification

  • Both sites yarn build clean (zero warnings); the prebuild vendor-config clone runs as part of the build.
  • Admin sitemap spot-checked: all service/resource routes emitted under https://anthropic-admin-provider.stackql.io.
  • docgen frontmatter's /img/stackql-<provider>-provider-featured-image.png references satisfied by aliasing stackql-cover.png per site.
  • CLAUDE.md website section updated with the archetype findings (vendor-config mechanics, sharp pin, monorepo projectName/editUrl exception).

🤖 Generated with Claude Code

https://claude.ai/code/session_01M5qQSBivc7W458yqJG9i5a


Generated by Claude Code

- thin docusaurus.config.js via createConfig from stackql/docusaurus-config,
  vendored at build time (yarn vendor-config prestart/prebuild hook;
  .shared-config gitignored) + provider.js identity module + shared
  sidebars/src/static from the archetype
- Docusaurus ^3.10.1 (faster, plugin-ideal-image, theme-mermaid) with the
  archetype's overrides/resolutions; sharp pinned ^0.33 on top (0.32 binary
  download breaks in restricted environments)
- monorepo fix: post-mutate projectName + per-site docs editUrl (createConfig
  derives stackql-provider-anthropicadmin otherwise); slug-derived admin URL
  is correct as-is
- deployment vector unchanged: Netlify per-site netlify.toml retained; CNAME
  and .nojekyll (Pages artifacts) not carried over
- both sites yarn build clean, zero warnings; sitemaps verified

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01M5qQSBivc7W458yqJG9i5a
@jeffreyaven jeffreyaven self-assigned this Jul 8, 2026
@jeffreyaven
jeffreyaven merged commit 6bc0433 into main Jul 8, 2026
3 checks passed
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.

2 participants