Asset System
Mission
Keep icons, illustrations, and imagery coherent across the product. Ensure visual assets fit the product's design direction and maintain strict consistency.
Asset Workflow
Follow these steps for every new asset:
- Define purpose: What is this asset communicating?
- Define dimensions: What is the required size and aspect ratio?
- Define visual style: Match the product's established design direction.
- Generate/source candidate: Create or locate the asset.
- Review consistency: Compare against existing assets in the product.
- Normalize: Adjust sizing, bounding boxes, or paths.
- Name semantically: Use clear naming (e.g.,
ic_action_search,img_onboarding_hero). - Integrate centrally: Add to the asset pipeline, public folder, or asset catalog.
- Check licensing: Ensure the asset is clear for use.
Asset Consistency Checks
Asset consistency must consider:
- Visual weight: Does a new icon look too heavy/thin compared to others?
- Perspective: Are illustrations isometric, flat, or 3D?
- Lighting: Are shadows and highlights consistent?
- Material: Do surfaces look metallic, matte, glossy?
- Stroke: Consistent stroke width and terminal caps (round vs. square)?
- Palette: Does it use the product's semantic or brand colors?
- Detail level: Are some icons overly detailed while others are minimalist?
Reference
Refer to docs/asset-guidelines.md for extended guidelines.


