ResQ npm Packages

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

Architecture

graph TB
    subgraph repo["resq-sw/npm"]
        direction TB
        subgraph frontend["Frontend"]
            ui["@resq-sw/ui<br/><small>57 components · Radix + Tailwind v4</small>"]
        end
        subgraph algorithms["Algorithms"]
            dsa["@resq-sw/dsa<br/><small>11 modules · zero deps</small>"]
        end
        subgraph infra["Infrastructure"]
            http["@resq-sw/http"]
            logger["@resq-sw/logger"]
            security["@resq-sw/security"]
            ratelimit["@resq-sw/rate-limiting"]
        end
        subgraph utilities["Utilities"]
            helpers["@resq-sw/helpers"]
            decorators["@resq-sw/decorators"]
        end
    end

    frontend --> apps["Consumer Apps"]
    algorithms --> apps
    infra --> apps
    utilities --> apps

    style repo fill:#0d0f14,stroke:#222b42,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 apps fill:#1a1e2e,stroke:#e24b4a,color:#f5f5f7

Loading

Packages

Package	Description	Deps	Docs
@resq-sw/ui	React component library — dark-first oklch color system, WCAG AA, subpath exports	radix-ui, tailwindcss	README · Storybook
@resq-sw/dsa	Data structures & algorithms — graph, heap, trie, bloom filter, distance, LRU cache, queue	zero deps	README
@resq-sw/http	Effect-based HTTP client with retry, timeout, and schema validation	effect	README
@resq-sw/logger	Structured logging with 7 levels, context, timing, and logging decorators	zero deps	README
@resq-sw/security	AES-256-GCM encryption, threat detection, PII sanitization, input validation	effect (peer)	README
@resq-sw/rate-limiting	Throttle, debounce, token bucket, leaky bucket, sliding window, Redis store	effect (peer)	README
@resq-sw/decorators	15 TypeScript decorators — memoize, throttle, debounce, bind, execTime, rateLimit	zero deps	README
@resq-sw/helpers	Result monad, type guards, date/number/string formatting, platform detection	@resq-sw/logger	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-sw/<pkg> test     # Test single package
bun --filter @resq-sw/<pkg> build    # Build single package
bun --filter @resq-sw/ui storybook   # Start Storybook dev server
bun --filter @resq-sw/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 Software