Design SystemsPulsegrid Design System MarkFour stepped pulse cells advancing along a rising rail

Design System Release 1.0

Pulsegrid

Operational bands that connect live status, evidence, and decisive action. Built for infrastructure, finance, analytics, service operations, and data heavy business products.

Turn live activity into the next clear decision.

  • Lead with the live question
  • Align proof with action
  • Make status structural
  • Reserve cobalt for the current path
  • Keep a quiet floor
Pulsegrid Design System MarkFour stepped pulse cells advancing along a rising rail
Installation command controls
npx agentkogei@latest addnpx agentkogei@latest add pulsegrid

Pulsegrid is retrieved anonymously from AgentKogei's public Design Systems collection. The CLI shows the absolute target and the exact change before it writes anything.

Design System Preview / Rendered evidence

One direction across the whole product.

Preview is evidence, not the Design Contract. It demonstrates direction and evaluated coverage; the Design Contract itself is public, so you can read every word before you add it.

01 / Principles

Principles and signature

Pulse 07

  1. 01Lead with the live question
  2. 02Align proof with action
  3. 03Make status structural
  4. 04Reserve cobalt for the current path
  5. 05Keep a quiet floor

02 / Semantic colors

Light and dark roles

Light

  • Background
    #f5f7fbThe quiet cool workspace behind navigation, operational bands, and application content.
  • Foreground
    #111827Primary copy, decisive headings, strong labels, and meaningful symbols.
  • Card
    #ffffffBounded tasks, independent evidence sets, dialogs, and focused working surfaces.
  • Muted
    #e9eef6Supporting bands, inactive regions, skeletons, and secondary data groupings.
  • Muted Foreground
    #526174Explanation, metadata, timestamps, and lower priority information.
  • Border
    #8996a8Defined control boundaries, data groups, pulse rails, and structural separators.
  • Primary
    #0018d4The current path, decisive action, active selection, and purposeful pulse cell.
  • Primary Foreground
    #ffffffReadable text and icons placed directly on the cobalt primary.
  • Destructive
    #aa263dIrreversible loss, failed requirements, and destructive confirmation.
  • Success
    #246942Verified completion and healthy outcomes paired with explicit text.
  • Warning
    #765400Conditions needing attention before they become failures.
  • Info
    #075d89Neutral operational context and informative status.
  • Ring
    #0018d4Persistent keyboard focus around every interactive component.

Dark

  • Background
    #0f1420The quiet cool workspace behind navigation, operational bands, and application content.
  • Foreground
    #f3f6fcPrimary copy, decisive headings, strong labels, and meaningful symbols.
  • Card
    #171e2bBounded tasks, independent evidence sets, dialogs, and focused working surfaces.
  • Muted
    #222b3aSupporting bands, inactive regions, skeletons, and secondary data groupings.
  • Muted Foreground
    #b6c0d0Explanation, metadata, timestamps, and lower priority information.
  • Border
    #657187Defined control boundaries, data groups, pulse rails, and structural separators.
  • Primary
    #6f8fffThe current path, decisive action, active selection, and purposeful pulse cell.
  • Primary Foreground
    #111827Readable text and icons placed directly on the cobalt primary.
  • Destructive
    #ff91a1Irreversible loss, failed requirements, and destructive confirmation.
  • Success
    #7bd8aaVerified completion and healthy outcomes paired with explicit text.
  • Warning
    #f0c56dConditions needing attention before they become failures.
  • Info
    #79caf4Neutral operational context and informative status.
  • Ring
    #6f8fffPersistent keyboard focus around every interactive component.

03 / Typography

Role based type scale

A distinct point of view.

Display

2.375rem to 4.5rem · 600 · 1 line height · -0.04em tracking

Product statements, major page decisions, and one leading operational outcome.

Section

Section

1.625rem to 2.625rem · 600 · 1.08 line height · -0.025em tracking

Section decisions, panel titles, and important grouped evidence.

Clear hierarchy makes complex product work easier to understand.

Body

0.9375rem to 1.0625rem · 400 · 1.58 line height · 0em tracking

Explanation, navigation, forms, settings, and sustained product reading.

EVALUATED DIRECTION

Label

0.6875rem to 0.75rem · 600 · 1.4 line height · 0.08em tracking

Pulse rail captions, status, timestamps, units, and compact data labels.

Metric

Metric

1.75rem to 2.5rem · 600 · 1 line height · -0.03em tracking

Measured values with explicit units, freshness, and explanatory labels.

npx agentkogei@latest add

Code

0.75rem to 0.8125rem · 400 · 1.5 line height · 0em tracking

Commands, machine values, identifiers, durations, and source text.

04 / Spacing

Spacing scale

  • 1

    0.25rem · Pulse cells, icons, and very tight status relationships.

  • 2

    0.5rem · Inline labels, metadata, and compact control groups.

  • 3

    0.75rem · Control internals and paired data values.

  • 4

    1rem · Default field rhythm and related actions.

  • 5

    1.25rem · Balanced table cells and dense evidence groups.

  • 6

    1.5rem · Cards, panels, and form groups.

  • 8

    2rem · Operational band padding and distinct task groups.

  • 12

    3rem · Section groups and compact surface transitions.

  • 16

    4rem · Major product sections and generous working separation.

  • 24

    6rem · High impact introductions and major decision transitions.

05 / Layout and responsive behavior

Constraints that preserve hierarchy

Connect each live question to evidence and action through aligned bands while keeping the surrounding field quiet.

Maximum 90rem · Reading width 68ch · Columns 1/6/12 · Gutters 1/1.5/2rem

  • Mobile

    320px and wider

    Stack decisions, evidence, and actions in source order with a labelled compact navigation trigger.

  • Tablet

    768px and wider

    Collapse secondary navigation and place supporting evidence below the principal decision when needed.

  • Desktop

    1120px and wider

    Use the twelve column field for one live question, aligned proof, and a ranked next action.

  • Zoom

    200% zoom

    Let navigation, labels, metrics, tables, and actions wrap or reflow without clipping.

  • Reflow

    320px reflow

    Preserve complete source ordered bands and use labelled overflow only for irreducible data comparison.

06 / Radius, borders, and elevation

Surface geometry and depth

Radius

  • Compact · 0.25rem · Data cells, tags, and compact controls.

  • Control · 0.375rem · Buttons, fields, menus, and ordinary interactions.

  • Panel · 0.5rem · Cards, dialogs, and bounded working surfaces.

Borders

  • Rail · 1px · Pulse rails, table groups, and structural bands.

  • Default · 1px · Controls, cards, and ordinary boundaries.

  • Focus · 2px · Focus, active selection, and consequential separation.

Elevation

  • Flat · Default bands, data groups, and working surfaces.

  • Raised · Temporary menus and movable content.

  • Overlay · Dialogs and temporary content above the operational field.

07 / Controls

Buttons and links

Use one filled primary action per decision band and keep secondary actions defined, direct, and stable. Use specific destinations, persistent prose underlines, and an explicit current navigation state.
Button states
Default
Hover
Focus
Active
Disabled
Loading
Success
Error
Link states
Interactive actionsView activity history

Ready for local interaction.

08 / Fields

Forms and inputs

Group fields by decision, keep help persistent, and place validation in the same reading path. Keep labels visible, align fields to the decision band, and reserve stable space for help and validation.
Incident routing

The selected team receives new incidents from this service.

09 / Containers

Cards and panels

Use a card for one independent task or proof set, not merely to add a border. Use one pulse rail and shared alignment instead of separate containers for every value.
Response window
A bounded task connects current health, ownership, freshness, and the next valid response.
Pulse 18 · Updated 4 minutes ago

Use a card for one independent task or proof set, not merely to add a border.

10 / Wayfinding

Navigation

Name the current section in text, preserve source order, and keep every destination keyboard reachable.

11 / Data

Tables, lists, and data display

Keep service, state, owner, freshness, and action aligned with tabular numerals and explicit labels. Preserve complete comparison in a labelled keyboard reachable scroll region when priority columns cannot fit.
Current service states
ServiceStateOwner · freshness
Edge gatewayHealthyPlatform · 2 minutes ago
Event streamInvestigatingData operations · 5 minutes ago
Billing syncRecoveredRevenue systems · 12 minutes ago

Activity summary

  • Healthy

    Fourteen services are within their response target.

    Verified
  • Investigating

    One event stream has delayed processing.

    Action needed
  • Recovered

    Billing sync returned to normal throughput.

    Monitor

12 / Feedback

Badges, alerts, and feedback states

Attach state to the affected service, preserve useful context, and include the next valid recovery. Pair every status color with a label, icon, boundary, or explicit state text.
  • PendingThe condition is awaiting evaluation
  • InvestigatingA named owner is examining the condition
  • HealthyThe service meets its verified operating target
  • AttentionA condition needs review before failure
  • UnavailableA failed requirement blocks the service
Feedback states
Loading

Refreshing service states without hiding the last verified state.

Empty

No services are connected to this operations view yet.

Filtered empty

No services match the active state and owner filters.

Error

Activity history could not refresh. The last verified state remains available.

Success

The response route is verified and active.

Disabled

Escalation remains unavailable until an active response team is assigned.

Destructive

Removing this service also removes its unresolved local activity history.

13 / Consequence

Dialogs and destructive actions

Keep the route summary concise, place safe review first, and preserve the originating service context. Repeat the service name, scope, consequence, and true recovery status before the destructive boundary.

Confirm response route

Review the service, owner, schedule, and escalation target before activation.

  • Escape closes the dialog because activation occurs only after explicit confirmation.
  • Return focus to the route control that opened the dialog.

Event stream service

Unresolved local activity history and routing preferences will be removed.

This preview action is reversible and changes only local specimen state.

Event stream service remains available.

Confirm response route

Review the service, owner, schedule, and escalation target before activation.

Remove Event stream service?

Unresolved local activity history and routing preferences will be removed.

This preview action is reversible and changes only local specimen state.

13

Motion and reduced motion

Timing supports state changes and never starts without a Builder action.
Motion specimen
Ready to move

The specimen is ready and does not autoplay.

Motion timings

feedback
100 ms
transition
160 ms
spatial
220 ms

Use short motion for response and continuity, allow pulse cells to fill only after action, and never add ambient loops.

Reduced motion

Remove translation, scaling, smooth scrolling, sequential fills, and loops while preserving immediate labelled state changes.

14

Accessibility guidance

Complete accessibility direction for the Design System Preview.
  • Semantics

    Use native landmarks, headings, controls, forms, tables, lists, dialogs, and status regions before adding ARIA.

  • Keyboard

    Keep navigation, menus, filters, sorting, selection, overflow regions, row actions, and dialogs operable in logical source order.

  • Focus

    Use a persistent two pixel focus indicator in light, dark, and forced colors modes and restore focus after modal interaction.

  • Contrast

    Measure text, controls, borders, status, meaningful graphics, and focus across both supported color schemes.

  • Target size

    Provide targets at least 24 by 24 CSS pixels with adequate spacing and prefer 44 pixels for important touch actions.

  • Zoom

    Preserve every navigation item, metric, label, table control, and action at 200 percent page zoom and 400 percent browser zoom.

  • Reflow

    Reflow operational bands to 320 CSS pixels without two dimensional page scrolling.

  • Forced colors

    Retain pulse structure, current selection, focus, boundaries, and feedback when system colors replace authored colors.

  • Status communication

    Announce asynchronous outcomes intentionally and never rely on color, position, shape, icon, or motion alone.

Preview

The Design System Preview is a public visual and descriptive specimen of the evaluated direction.

Design Contract

The complete Design Contract is the public raw Markdown installed into a Project.

Evaluation evidence

Evaluation metadata and raw evidence paths remain public so coverage can be inspected.

Read the methodology

Release 1.0

Release details

Release evidence

Public metadata for release 1.0.
Compatibility
React >=18 <20 · Next.js >=15 <17 · Tailwind >=4 <5 · shadcn/ui
Evaluation
Design System Evaluation passed · WCAG 2.2 Level AA reference implementation
Evidence coverage
  • 1440x900 · 390x844
  • Light · Dark · Reduced motion
  • Originality review passed · Automated validation passed
  • 1 agent generation runs
  • structure · accessibility · responsive overflow · color contrast
  • evaluation/report.json

Coverage

Required surfaces and system states.
  • Marketing
  • Authentication
  • Onboarding
  • Dashboard
  • Table
  • Form
  • Settings
  • States

Inside the Design Contract

Installation writes one root DESIGN.md and nothing beside it.
  • Interface principles, layout, and product surfaces
  • Semantic tokens and their definitions
  • Components, interaction states, and feedback
  • Motion and accessibility direction
  • Agent instructions and worked examples
  • A final validation checklist
  • React or Next.js, Tailwind CSS v4, and shadcn/ui implementation direction
Learn how Design Contracts direct future agent work

Design Contract and changelog

The complete agent direction for Release 1.0.

Release 1.0

Changelog

Initial Pulsegrid Design System Release.

Read Pulsegrid 1.0 Design Contract
View raw Design Contract