Skip to content

fix(docs): UI/UX audit fixes (blank page, counts, contrast, favicon) - #139

Merged
ajianaz merged 1 commit into
developfrom
fix/docs-ui-audit
Oct 7, 2026
Merged

ajianaz merged 1 commit into
developfrom
fix/docs-ui-audit

Conversation

@ajianaz

@ajianaz ajianaz commented Oct 7, 2026

Copy link
Copy Markdown
Contributor

What

Fixes the findings from the docs UI/UX audit.

Why

/guide/template-authoring rendered blank (inline {{ brand.brand_name }} parsed by Vue → SSR TypeError, build still exited 0), template counts disagreed (18 / 148 / actual 159), the brand button was 2.03:1 in light mode, and no favicon/logo was wired. Closes #138.

How

  • markdown.config: inline code gets v-pre.
  • Template count read from templates/ in config.ts; used for the home feature, og description, sidebar and templates index. README/quick-start say "150+" to avoid drift.
  • Light-mode brand tokens darkened (white on #6d28d9 ≈ 8:1); pastels kept for dark mode.
  • Favicon/apple-touch-icon links and header logo.
  • svg fences → xml (no more highlight warnings); mobile tables scroll.
  • docs.yml fails on TypeError/ReferenceError/SyntaxError in the build log (verified it catches the old state and passes the new).

Not done: 6 templates have no docs page/preview yet (audiogram-card, linkedin-text-post, meme-text-card, sparkline-card, testimonial-card, tweet-screenshot), and the Announcement preview image (hosted on S3) still says "18 templates".

Testing

  • bun run build clean (no errors/warnings)
  • Visual check in browser: authoring page renders, light-mode button contrast, favicon/logo, counts
  • CI guard fails on the pre-fix build, passes on the fixed one

Related Issues

Closes #138

Checklist

  • Branch name follows convention
  • Branch is from develop

🤖 Generated with Claude Code

… favicon (#138)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Oct 7, 2026

Copy link
Copy Markdown

🔍 Cora AI Code Review

✅ No issues found. Code looks good!


Review powered by cora-code · BYOK · MIT

@ajianaz
ajianaz merged commit 41641bc into develop Oct 7, 2026
11 checks passed
@ajianaz
ajianaz deleted the fix/docs-ui-audit branch October 7, 2026 09:26
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.

fix(docs): blank Template Authoring page, stale template counts, light-mode contrast, missing favicon

1 participant