designseeddocs

Community

Review process

2 min read

Library submissions go through a structured review on GitHub. Most ship in 5–10 days; complex submissions can take longer.

The pipeline

PR opened
  → CI validates
  → Curator triage (within 48h)
  → Curator review (5-10 days)
  → Author iteration
  → Merge
  → Live in library (within 24h)

CI validation

The instant your PR opens, CI runs:

  • designdrop validate brands/<slug>/DESIGN.md — schema + contrast.
  • Round-trip check — emit CSS / Tailwind / DTCG and parse back; assert no drift.
  • Visual diff — render the included sample UI against the source brand's screenshot. We look for "feels like the brand" not "pixel-perfect".

CI must be green before a curator picks up the PR.

Curator triage (within 48h)

A curator labels the PR with one of:

  • refinement — a fix to an existing entry. Faster path; usually merged in 2–3 days.
  • new-brand — a new entry. Goes to the new-brand queue (5–10 day average).
  • needs-changes — submission isn't ready. Author iterates.
  • out-of-scope — doesn't fit the library. Closed with explanation.

You'll get a comment with the label + next steps.

Curator review

A curator works through:

  1. Brand fidelity. Does the result feel like the source brand? They'll often render it next to a real screenshot of the brand to compare.
  2. Token coverage. Missing roles? Thin scales? Need a surface token? Curator suggests additions.
  3. Patterns section. Does the prose actually help an AI agent generate on-brand UI? Or is it generic?
  4. Theme parity. If light has 12 tokens, does dark too? Are they thoughtfully different (not just inverted)?

Reviewers leave inline comments. Most submissions go through 1–2 rounds before merging.

Iteration

Push fixes to the same PR branch. CI re-runs automatically. The curator gets a re-review notification.

Tips that speed up iteration:

  • Address all comments in one push, not one-by-one.
  • Open a thread under each comment with your reasoning before pushing the fix — sometimes a one-line clarification resolves the comment without a code change.
  • Tag the curator (e.g. @kao-designdrop) when you've pushed updates and want re-review.

Merge + ship

Once approved:

  1. Curator merges to main.
  2. The library content service syncs within 24h.
  3. Your entry appears in the curated grid + brand detail pages.
  4. Your GitHub handle appears as the contributor on the brand page.

Reviewer roster

The reviewer team is listed in github.com/designdrop-app/library-content/CONTRIBUTORS.md. Want to join? Ship 5+ accepted submissions; we'll reach out.