ResQ Systems npm Packages

Registry workspace for all ResQ Systems npm packages published under the @resq-systems scope. Provides the shared UI component library, zero-dependency data structures, and standalone server/client utilities for the ResQ Systems autonomous disaster response platform.

Architecture

graph TB
subgraph repo["resq-software/npm"]
direction TB
subgraph foundation["Foundation"]
constants["@resq-systems/constants<br/><small>design tokens · brand · zero deps</small>"]
types["@resq-systems/types<br/><small>nominal/branded types · zero deps</small>"]
end
subgraph frontend["Frontend"]
ui["@resq-systems/ui<br/><small>63 components + flight instruments · Radix + Tailwind v4</small>"]
end
subgraph algorithms["Algorithms"]
dsa["@resq-systems/dsa<br/><small>11 modules · zero deps</small>"]
end
subgraph infra["Infrastructure"]
http["@resq-systems/http"]
logger["@resq-systems/logger"]
security["@resq-systems/security"]
ratelimit["@resq-systems/rate-limiting"]
email["@resq-systems/email-templates<br/><small>React Email · Effect contract</small>"]
end
subgraph utilities["Utilities"]
helpers["@resq-systems/helpers"]
decorators["@resq-systems/decorators"]
end
subgraph telemetry["Telemetry"]
analytics["@resq-systems/analytics<br/><small>PostHog + GA4 · cross-subdomain</small>"]
wsclient["@resq-systems/telemetry<br/><small>reconnecting WebSocket · fan-out</small>"]
geomap["@resq-systems/map<br/><small>MapLibre + react-map-gl</small>"]
end
end
constants --> ui
constants --> email
wsclient --> geomap
foundation --> apps["Consumer Apps"]
frontend --> apps
algorithms --> apps
infra --> apps
utilities --> apps
telemetry --> apps
style repo fill:#0d0f14,stroke:#222b42,color:#f5f5f7
style foundation fill:#141722,stroke:#5db8ff,color:#f5f5f7
style frontend fill:#141722,stroke:#388feb,color:#f5f5f7
style algorithms fill:#141722,stroke:#25c68a,color:#f5f5f7
style infra fill:#141722,stroke:#f5a623,color:#f5f5f7
style utilities fill:#141722,stroke:#9ba3b5,color:#f5f5f7
style telemetry fill:#141722,stroke:#b478ff,color:#f5f5f7
style apps fill:#1a1e2e,stroke:#e24b4a,color:#f5f5f7

Loading

Packages

Package	Description	Deps	Docs
@resq-systems/constants	Shared design tokens (oklch + email-safe hex), brand identity, and cross-app values — one source of truth	zero deps	README
@resq-systems/types	Nominal/branded type toolkit — Brand, Opaque, NumberRange, numeric brands, assertNever, and type-level test helpers	zero deps	README
@resq-systems/ui	React component library — dark-first oklch color system, WCAG AA, subpath exports; 63 components incl. the basic-six flight instruments	radix-ui, tailwindcss	README · Storybook
@resq-systems/dsa	Data structures & algorithms — graph, heap, trie, bloom filter, distance, LRU cache, queue	zero deps	README
@resq-systems/http	Effect-based HTTP client with retry, timeout, and schema validation	effect	README
@resq-systems/logger	Structured logging with 7 levels, context, timing, and logging decorators	zero deps	README
@resq-systems/security	AES-256-GCM encryption, threat detection, PII sanitization, input validation	effect (peer)	README
@resq-systems/rate-limiting	Throttle, debounce, token bucket, leaky bucket, sliding window, Redis store	effect (peer)	README
@resq-systems/decorators	15 TypeScript decorators — memoize, throttle, debounce, bind, execTime, rateLimit	zero deps	README
@resq-systems/helpers	Result monad, type guards, date/number/string formatting, platform detection	@resq-systems/logger	README
@resq-systems/analytics	Unified PostHog + GA4 client — cross-subdomain identity, lazy-loaded, typed events, Next.js + React adapters	posthog-js (peer)	README
@resq-systems/telemetry	Framework-agnostic reconnecting WebSocket client — single-owner socket, exponential backoff, many-consumer fan-out, open-replay; optional React bindings	zero deps · react (peer)	README
@resq-systems/map	MapLibre + react-map-gl telemetry primitives — themeable map shell, asset markers, GeoJSON tracks, live position binding to @resq-systems/telemetry	maplibre-gl, react-map-gl (peers)	README
@resq-systems/email-templates	Type-safe transactional emails — Effect Schema contract, React Email components, headless render, optional Resend sender	react, effect, @react-email	README

Examples

Working examples showing the packages in action:

Example	What it demonstrates	Run
react-dashboard	Mission Control UI using all packages — cards, tables, badges, distance calculations, priority queues, throttled actions, sanitized logs	bun --filter example-react-dashboard dev
node-api	Bun.serve() HTTP server with structured logging, rate limiting, PII sanitization, request tracking	bun --filter example-node-api dev
dsa-pathfinding	Earthquake drone response — Graph pathfinding, PriorityQueue triage, BloomFilter survey tracking, Trie dispatch lookup	bun --filter example-dsa-pathfinding start

Design Assets

Brand assets live in design/ — logos, icons, PWA assets, and the engineering style guide.

Asset	Variants	Formats
Drone coordination mark	resq-mark-color, resq-mark-mono-black, resq-mark-mono-white	svg, png, webp
Logo lockups	horizontal, stacked, tagline, mono (dark + light)	svg, png, webp
Gradient mark	resq-mark-gradient — full-bleed mark on dark	svg, png, webp
OG banner	Social sharing card	svg, png, webp
PWA icons	Android, iOS, Windows 11	png, webp
Style guide	oklch color tokens, typography, spacing, component rules	—
Logo system	Lockup specs, icon sizing, usage guidelines	pdf

Development

Prerequisites

• Bun >= 1.x
• Node.js >= 20.19.0

Setup

git clone https://github.com/resq-software/npm.git
cd npm
bun install

Commands

bun install # Install all workspace dependencies
bun test# Run all workspace tests
bun run build # Build all packages
bun --filter @resq-systems/<pkg>test# Test single package
bun --filter @resq-systems/<pkg> build # Build single package
bun --filter @resq-systems/ui storybook # Start Storybook dev server
bun --filter @resq-systems/ui lint # Lint with Biome
bun changeset # Create a changeset for versioning

Stack

Layer	Tool
Runtime	Bun 1.x
Language	TypeScript (strict)
Build	tsdown
Testing	Vitest
Linting	Biome
Versioning	Changesets
Visual testing	Chromatic (UI)

Contributing

1. Branch from master and make changes in the relevant packages/ directory.
2. Run bun test to verify nothing breaks.
3. Run bun changeset to describe your changes for the changelog.
4. Submit a Pull Request.

Commits follow Conventional Commits (feat:, fix:, chore:, perf:, refactor:). See CONTRIBUTING.md and DEVELOPMENT.md for full details.

License

Apache-2.0 — see LICENSE.md.

Copyright 2026 ResQ Systems, Inc.