Radarist project

Radarist / Design system

Documentation v0.1 · Product in progress

Design system contents

Components

Project cards and ordering

Show a project’s identity and next action together, with separate controls for opening, completion, and ordering.

On this page

Purpose and usage

Show a project’s identity and next action together, with separate controls for opening, completion, and ordering.

Use for overview/prioritization. Use an agenda block when the project is being placed in time.

Anatomy

Anatomy
PartContract
Space labelShort context above the project title.
Project titlePrimary identity with open-project overlay link.
Next actionTaskCheckbox below a divider.
Ordering handleNumbered handle with drag and keyboard affordance.

Variants and configuration

Variants and configuration
ConfigurationBehavior
Identityteal, blue, plum, sand, coral.
positionEnables ordered-card presentation.
draggingReduced opacity and changed shadow.
CallbacksDrag handlers and onHandleKeyDown supplied by parent.

State coverage

State coverage
StateImplemented behavior
RestingProject fill, border and paired text roles.
HoverRaised card and stronger shadow.
Drag active45% opacity.
Keyboard orderingProjectsWorkspace provides arrow-key handling.

Interaction and responsive behavior

  • Do not place task completion beneath an unbreakable whole-card link. The source separates the overlay and task z layers.
  • Keep local project order and persisted order coordinated.
  • Next-action text is clamped to two lines in a card; use detail view for full context.

Accessibility contract

  • Open link names the project.
  • Order handle names the position/project and explains arrow-key reordering.
  • Task control remains an independent action.

Known gaps and readiness

Ordering persistence is stubbed for captures. Reordering animation uses JavaScript and needs explicit reduced-motion verification.

Composition example

<ProjectCard color="teal" project="Atlas customer portal"
  space="Product" nextAction="Review account settings"
  href="/projects/atlas-portal" position={1}
  onHandleKeyDown={handleReorder} />

Source references

Source references
FileResponsibility
app/components/project-card.tsxCard anatomy and task control
app/components/projects-workspace.tsxOrdering state and keyboard handlers

Examples from the app

Actual Radarist components with fictional data. Captured at 2× resolution or higher. Select an image to inspect it full size.

Project Card · Component detail · Light · Desktop · 1864 × 1782 px
Projects · Screen · Light · Desktop · 2880 × 2000 px
Projects · Screen · Light · Desktop · Full Page · 2880 × 2104 px

Source audit: 2026-10-07 · Revision 0103e2549959 · Documentation v0.1