claude.ai/design: Adding templates/*.dc.html to a synced DS project de-lists it from the picker

Open 💬 0 comments Opened Jun 23, 2026 by mzils-rgb

Summary

Uploading templates/<slug>/<Name>.dc.html files with <!-- @template … --> headers to a synced design system project causes the entire design system to disappear from the "select a design system" picker. Removing the template files restores it.

Steps to reproduce

  1. Have a working synced design system project (visible in the picker)
  2. Upload one or more files matching templates/<slug>/<Name>.dc.html with a <!-- @template … --> comment header to the project (via the DesignSync write_files tool)
  3. Refresh claude.ai/design

Expected behavior

The design system remains visible in the picker. The uploaded templates appear as starting points when creating a new design with that system.

Actual behavior

The entire design system disappears from the "select a design system" picker. check_design_system still reports the system as valid and in-sync. Deleting the templates/ folder from the project restores the design system in the picker.

Additional context

The Claude Design agent explicitly recommended using templates for starting points and described a templates/<slug>/<Name>.dc.html + <!-- @template … --> format. Following that guidance triggers this bug. There is currently no working mechanism to add starting points to a synced design system without causing it to be de-listed.

Environment

  • Claude Code CLI (terminal)
  • claude.ai/design (browser)
  • Design system project type: PROJECT_TYPE_DESIGN_SYSTEM
  • Reproduced on: 2026-06-23

View original on GitHub ↗