crocotasteexamplesGitHub

Watch Crocotaste review real pull requests

A small Next.js app on shadcn/ui and Tailwind. Each example shows the change, and exactly what Crocotaste posted on it.

12 steps · 11 pull requests · 8 reviews with findings

How Crocotaste works

A GitHub App, with no CI step to write and no package to add
  1. Install the GitHub App

    It opens one issue, and your coding agent turns it into the DESIGN.md every review reads.

  2. Open a pull request

    Each UI change is read against your tokens, your components and your team's decisions.

  3. Read the review

    Findings land on the changed line, each citing its source, most with a one-click fix.

The examples

From install to a green check, every post quoted unedited

Catches · 3 of 12

SetupIssue #1

The onboarding issue

Crocotaste opens one issue, with instructions your coding agent can follow.

Generate your DESIGN.md #1

crocotaste opened Generate your DESIGN.md

Crocotaste reviews every UI pull request here against your design system: your tokens, your components, your team's decisions. The sharpest reviews come from a DESIGN.md, and the same file is what makes your coding agent write on-system UI in the first place.

Instructions for your coding agent

You are working in the repository crocotaste/crocotaste-examples. Write a DESIGN.md at the repository root that describes this codebase's design system as it actually is, in the Google Labs DESIGN.md format (https://github.com/google-labs-code/design.md).

Read the code first, and take every value from it:
SetupPull request #2

Adding DESIGN.md

The agent's pull request, and what Crocotaste read once it merged.

Added DESIGN.md file #2

DESIGN.md
Added: ---Added: version: alphaAdded: name: Crocotaste examplesAdded: description: A single-page Next.js static export on shadcn/ui (radix-nova, neutral base) and Tailwind CSS 4, themed green with a dark brand field.

crocotaste commented

Parsed DESIGN.md · 51 tokens · 26 components · 48 conventions · 0 decisions Every review of this repository now cites it.

NeutralCrocotaste checkSkipped · no UI files changed
ViolationPull request #3

A Tailwind color where a theme token exists

text-red-600 is the theme's destructive red, written raw.

Explain what each verdict does to the check #3

src/app/page.tsx:183
Added: <p className="mt-4 text-sm text-muted-foreground">Added:   <span className="font-medium text-red-600">{VERDICT_NOTE.lead}</span>

crocotaste commented on the line

Violation text-red-600 is --color-destructive — use the token (src/app/globals.css:24)

Source: src/app/globals.css:24

Suggested change

<span className="font-medium text-destructive">{VERDICT_NOTE.lead}</span>
NeutralCrocotaste check1 finding · 1 violation · 0 drift
ViolationPull request #4

A hex that several roles share

White is six tokens here, so it names them all and guesses none.

Say who posted the reviews under the hero #4

src/app/page.tsx:122
Unchanged: </div>Added: <p className="mt-6 text-sm text-[#ffffff]">{HERO_NOTE}</p>

crocotaste commented on the line

Violation #ffffff is --color-card, --color-popover, --color-primary-foreground, --color-brand-field-foreground and 2 more in your palette — use the one for this role (src/app/globals.css:12)

Source: src/app/globals.css:12

NeutralCrocotaste check1 finding · 1 violation · 0 drift
DriftPull request #5

A spacing value just off the scale

A near miss is drift: it is named, and the check stays green.

Give the check tiles more room #5

src/app/page.tsx:139
Removed: <div key={check.title} className="rounded-lg bg-muted p-4">Added: <div key={check.title} className="rounded-lg bg-muted p-[18px]">

crocotaste commented on the line

Drift 18px isn't on your spacing scale — nearest spacing.card is 16px (DESIGN.md:92)

Source: DESIGN.md:92

SuccessCrocotaste check1 finding · 0 violations · 1 drift
DriftPull request #6

A radius off the scale

The nearest step on the radius scale, as a one-click fix.

Soften the corners of the sample finding #6

src/app/page.tsx:161
Removed: <div className="overflow-hidden rounded-lg border">Added: <div className="overflow-hidden rounded-[12px] border">

crocotaste commented on the line

Drift 12px isn't on your radius scale — nearest --radius-lg is 10px (src/app/globals.css:47)

Source: src/app/globals.css:47

Suggested change

<div className="overflow-hidden rounded-lg border">
SuccessCrocotaste check1 finding · 0 violations · 1 drift
ViolationPull request #7

A token that does not exist

A misspelled var() that would silently render nothing.

Colour text selection with the brand green #7

src/app/globals.css:142
Added: ::selection {Added:   background-color: var(--primay);

crocotaste commented on the line

Violation --primay isn't defined in your stylesheets — nearest is --primary (src/app/globals.css:62)

Source: src/app/globals.css:62

Suggested change

  background-color: var(--primary);
NeutralCrocotaste check1 finding · 1 violation · 0 drift
ViolationPull request #8

A button built from scratch

Every class is on-system, so the AI review catches it, citing the rule.

Link the DESIGN.md standard from the try-it card #8

src/app/page.tsx:251
Added: <aAdded:   href={siteUrl(STANDARD_LINK.path)}Added:   className="inline-flex h-9 items-center gap-1.5 rounded-lg border border-border bg-background px-2.5 text-sm font-medium hover:bg-muted"Added: >

crocotaste commented on the line

Violation A bare <a> is styled by hand as a button (border border-border bg-background, rounded-lg, h-9, hover:bg-muted) where Button with the outline variant exists. DESIGN.md says to use Button asChild around an <a> for a link styled as a button.

Source: DESIGN.md:329

NeutralCrocotaste check1 finding · 1 violation · 0 drift
CommandPull request #9

Dismissing a finding

A reply with @crocotaste ignore dismisses it and drafts the decision to record.

Close the page with a call to action on the brand field #9

src/app/page.tsx:229
Removed: <Card>Added: <section className="rounded-3xl bg-brand-field px-6 py-12 md:px-10">

crocotaste commented on the line

Violation The section is a hand-drawn box (rounded-3xl bg-brand-field) where Card with CardHeader and CardContent exists. The removed lines used Card. rounded-3xl and brand-field are the hero's look, and this is not the hero. The rule is DESIGN.md:330.

Source: DESIGN.md:330

mfbz replied

@crocotaste ignore Brand-field panels are the page's calls to action: the hero opens the page and the closing banner ends it, full width on bg-brand-field with rounded-3xl. Content sections stay in a Card.

crocotaste replied

Dismissed on this pull request. To make it hold everywhere, add this to DESIGN.md under ## Decisions:

### a hand-drawn box

Brand-field panels are the page's calls to action: the hero opens the page and the closing banner ends it, full width on bg-brand-field with rounded-3xl. Content sections stay in a Card. Source: DESIGN.md:330.
SuccessCrocotaste checkOn-system · 1 file · 125 tokens · 30 components · 0 decisions · 0 violations
DecisionPull request #10

Recording the decision

The drafted block merged into DESIGN.md, where every review reads it.

Record decision: brand-field panels are the page's calls to action #10

DESIGN.md
Unchanged: ## DecisionsAdded: ### Brand-field panels are the page's calls to actionAdded: Brand-field panels are the page's calls to action: the hero opens the page and the closing banner ends it, full width on bg-brand-field with rounded-3xl. Content sections stay in a Card. Source: DESIGN.md:330.

crocotaste commented

Parsed DESIGN.md · 51 tokens · 26 components · 48 conventions · 1 decisions Every review of this repository now cites it.

NeutralCrocotaste checkSkipped · no UI files changed
ViolationPull request #11

Breaking the recorded decision

No general rule forbids this panel. The decision does, and the finding cites it.

Add an install call to action halfway down the page #11

src/app/page.tsx:189
Added: function MidCta() {Added:   return (Added:     <section className="mx-auto max-w-xl rounded-xl bg-brand-field px-6 py-8 text-center">

crocotaste commented on the line

Violation This mid-page section uses bg-brand-field with max-w-xl and rounded-xl. The decision at DESIGN.md:350 limits brand-field panels to the hero and the closing banner, full width with rounded-3xl. Content sections stay in a Card.

Source: DESIGN.md:350

NeutralCrocotaste check1 finding · 1 violation · 0 drift
PassPull request #12

A clean pull request

Nothing off-system, so the check goes green and it approves.

Move the walkthrough description into the page copy #12

src/app/page.tsx
Removed: <CardDescription>Removed:   From install to a green check, one pull request at a timeRemoved: </CardDescription>Added: <CardDescription>{WALKTHROUGH_LEDE}</CardDescription>

crocotaste approved these changes

Nothing to snap at.

SuccessCrocotaste checkOn-system · 1 file · 125 tokens · 30 components · 1 decisions · 0 violations

How to read a finding

The value, the token, then the source, in that order
src/app/globals.css:142
Added: ::selection {Added:   background-color: var(--primay);

crocotaste commented on the line

Violation

--primay isn't defined in your stylesheets — nearest is --primary (src/app/globals.css:62)

Source: src/app/globals.css:62

Suggested change

  background-color: var(--primary);
  1. The verdict

    A violation breaks a rule and leaves the check neutral. Drift is a near miss, and the check stays green.

  2. The value and the token

    What the changed line wrote, then the token your theme already has for it.

  3. The source

    The file and line in this repository the rule comes from. A finding with no source is deleted before it's posted.

  4. The fix

    A suggested change you can commit from the pull request in one click.

The check is never red, and it never blocks a merge.

Try it on your own repository

Install the GitHub App, and your first three reviews are free