Georgia Orchard Design System
Build within the system's documented scope and delivery model.
Before editing
- Confirm the product owner and that this system is authorized for the target surface.
- Read references/implementation.md before installing or changing dependencies.
- Read references/sources.md when checking versions, provenance, license, or release state.
- Inspect the existing framework, package manager, asset pipeline, and accessibility tests. Preserve them unless the official integration requires a change.
Workflow
- Choose one documented delivery path — the npm package or the versioned CDN stylesheets; do not mix them accidentally.
- Pin the dependency or CDN asset version and keep upstream notices.
- Reuse official components, palettes, content guidance, and templates before adding custom UI.
- Extend through documented mechanisms such as the agency palette stylesheets and composition. Do not edit vendored package files.
- Test semantic structure, keyboard operation, focus order and visibility, accessible names, error recovery, zoom/reflow, contrast, and target browsers.
- Report custom patterns, unsupported requirements, and upstream gaps explicitly.
Boundaries
- Scope: Georgia state-government sites and applications authorized to use Orchard, not county or municipal products.
- Release: the official npm package and versioned CDN assets are current. No public source repository was verified — the package ships compiled assets.
- Delivery: npm package with compiled CSS, per-component JavaScript bundles, and agency palette stylesheets; versioned CDN stylesheets; Storybook-style documentation with component examples.
- Do not invent component APIs, tokens, package names, or compliance claims.
- Do not import another jurisdiction's branding to fill a gap.
- A passing component example does not prove the completed service conforms to WCAG, Section 508, the ADA, or local policy.
References
- Implementation — packages, setup, and integration decisions
- Sources — authoritative URLs, snapshot versions, ownership, and license notes