# DESIGN.md

## Brand

Riverbend Food Initiative is a fictional nonprofit that helps neighborhood food banks forecast demand, coordinate pickups, and explain impact to local donors.

## Colors

- Primary: `#1F5E5A`, used for headings, charts, and primary buttons.
- Accent: `#E08B4F`, used for highlights, small callouts, and chart comparison marks.
- Surface: `#F7F3EA`, used for warm report backgrounds.
- Ink: `#17211F`, used for body text.
- Muted: `#66736F`, used for labels and captions.

## Type

- Headings: `Inter`, 700 weight.
- Body: `Inter`, 400 weight.
- Numbers and small labels: `IBM Plex Mono`, 500 weight.

## Voice

Warm, direct, and practical. Use concrete community language. Avoid inflated impact language unless a number or source supports it.

## Components

- Cards use square corners, a 1px `#D7D0C3` border, and no drop shadow.
- Primary buttons use `#1F5E5A` background, white text, and square corners.
- Charts use muted grid lines and label the takeaway in the chart caption.
- Reports should feel calm, useful, and board-ready.

## Source Notes

- This is a public-safe workshop fallback, not a live extraction from a real organization.
- Colors and typography are intentionally supplied as the source of truth for the demo path.
- Treat any partner names, donor commitments, delivery totals, or funding claims as missing unless they appear in the CSV or a facilitator-supplied note.

## Do

- Use real counts, dates, and source names.
- Put one decision or takeaway per slide.
- Show uncertainty clearly when data is incomplete.

## Do Not

- Do not invent partner names, donor commitments, or delivery totals.
- Do not use decorative gradients or rounded marketing cards.
- Do not make claims without a source note.