Skip to content

docs: fix build, restore devframe sidebar import, unify Devframe casing#322

Merged
antfu merged 1 commit intomainfrom
antfu/fix-docs-build
May 8, 2026
Merged

docs: fix build, restore devframe sidebar import, unify Devframe casing#322
antfu merged 1 commit intomainfrom
antfu/fix-docs-build

Conversation

@antfu
Copy link
Copy Markdown
Member

@antfu antfu commented May 8, 2026

Description

Restores the docs build, which has been broken on main since #317 (a merge conflict resolution reverted the cleanup from #316). Concretely:

  • docs/.vitepress/config.ts was importing devframeSidebar from '../../devframe/docs/.vitepress/sidebar', a file deleted in docs: glob error code pages and rehost devframe nav #316 — both pnpm docs:build and the Netlify deploy fail at config load. Restored the named import (devframeNav, devframeSidebar) from '../../devframe/docs/.vitepress/config', the tinyglobby-based listErrorCodes helper, and the devframeNav('/devframe') top-nav entry. The hardcoded DTK error-code array was also stale (claimed DTK0001–DTK0032 but most files don't exist) — back to globbing.
  • Widened srcExclude from 'skills/**' to '**/skills/**' so devframe/skills/devframe/SKILL.md (an AI agent skill, not a docs page) is no longer pulled into the docs srcDir, where its relative links resolved to dead targets.
  • Normalized 52 occurrences of DevFrameDevframe across docs prose, READMEs, AGENTS.md, sidebar/title strings, and the @devframes/nuxt package description, for brand consistency.

Linked Issues

Additional context

Verified locally: pnpm -C docs run docs:build and pnpm -C devframe/docs run docs:build both build cleanly. The Netlify build runs pnpm run build && pnpm run docs:build, which mirrors the local verification.

The post-#317 merge conflict reverted the cleanup from #316 — the
docs/.vitepress/config.ts import pointed at a deleted sidebar.ts and the
error-reference sidebar held a hardcoded list of DTK codes that no longer
matched the actual files. Restored the named import from devframe/docs/
.vitepress/config, the tinyglobby-based listErrorCodes helper, and the
devframeNav top-nav entry. Also widened srcExclude from skills/** to
**/skills/** so devframe/skills/devframe/SKILL.md (an AI agent skill, not a
docs page) is not picked up as a 404-laden source. Finally, normalized 52
occurrences of DevFrame to Devframe across docs, READMEs, AGENTS.md, and
package metadata for brand consistency.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@netlify
Copy link
Copy Markdown

netlify Bot commented May 8, 2026

Deploy Preview for devfra ready!

Name Link
🔨 Latest commit d823292
🔍 Latest deploy log https://app.netlify.com/projects/devfra/deploys/69fda958ba4a4e000855aa70
😎 Deploy Preview https://deploy-preview-322--devfra.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@antfu antfu merged commit edd9f93 into main May 8, 2026
10 of 11 checks passed
@antfu antfu deleted the antfu/fix-docs-build branch May 8, 2026 09:14
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