# TimeWarp Software

> Landing pages for TimeWarp Engineering's open source NuGet libraries. This site is agent-first: every page has a canonical markdown twin at `<page-url>index.md` — the links below point straight at the markdown. The machine-readable package catalog is at /packages/index.json.

## Docs

- [TimeWarp Software](https://timewarp.software/index.md): A showcase of TimeWarp Engineering's NuGet libraries and open source projects.
- [Tip jar](https://timewarp.software/tip/index.md): Free docs for the optional tip jar. Site content stays free; x402 payment only at /api/tip. Agents can pay Base USDC, Lightning sats, or Cardano ADA; humans can also pay Lightning to tip@timewarp.software.

## Packages

- [TimeWarp.State](https://timewarp.software/packages/timewarp.state/index.md): State management for .NET. Blazor components, JavaScript interop, and render subscriptions are in TimeWarp.State.Blazor.
- [timewarp-simple-icons](https://timewarp.software/packages/timewarp-simple-icons/index.md): All of the simple-icons wrapped as Blazor components.
- [TimeWarp.Nuru](https://timewarp.software/packages/timewarp.nuru/index.md): Route-based CLI framework for .NET - batteries included with telemetry, REPL, and shell completion
- [TimeWarp.State.Plus](https://timewarp.software/packages/timewarp.state.plus/index.md): TimeWarp.State.Plus extends TimeWarp.State and TimeWarp.State.Blazor with routing, persistence, and action tracking.
- [TimeWarp.Architecture](https://timewarp.software/packages/timewarp.architecture/index.md): TimeWarp Architecture Templates
- [TimeWarp.Nuru.Analyzers](https://timewarp.software/packages/timewarp.nuru.analyzers/index.md): Roslyn analyzers for TimeWarp.Nuru route pattern validation
- [TimeWarp.Mediator.Contracts](https://timewarp.software/packages/timewarp.mediator.contracts/index.md): Contract-only package for TimeWarp.Mediator: IRequest, ICommand, IQuery, INotification, IStreamRequest, their handler and pipeline-behavior interfaces, ISender/IPublisher/IMediator, and the scope/modu…
- [TimeWarp.Nuru.Mcp](https://timewarp.software/packages/timewarp.nuru.mcp/index.md): MCP server for TimeWarp.Nuru providing route validation, syntax documentation, example code, and handler generation for AI-assisted CLI development.
- [TimeWarp.Mediator](https://timewarp.software/packages/timewarp.mediator/index.md): Reflection-based mediator (MediatR fork): AddMediator() registers request/response, notifications, streams, and pipeline behaviors over Microsoft.Extensions.DependencyInjection by assembly scan. The s…
- [TimeWarp.Amuru](https://timewarp.software/packages/timewarp.amuru/index.md): Fluent API for elegant C# scripting with pipeline support
- [TimeWarp.Terminal](https://timewarp.software/packages/timewarp.terminal/index.md): Terminal abstractions and widgets for console applications - IConsole, ITerminal, panels, tables, rules, and ANSI color support
- [TimeWarp.Build.Tasks](https://timewarp.software/packages/timewarp.build.tasks/index.md): MSBuild tasks for TimeWarp projects including git metadata injection and build automation
- [TimeWarp.State.Policies](https://timewarp.software/packages/timewarp.state.policies/index.md): Policies for TimeWarp State management library
- [TimeWarp.Builder](https://timewarp.software/packages/timewarp.builder/index.md): Fluent builder interfaces and scope extensions for TimeWarp projects
- [TimeWarp.Fixie](https://timewarp.software/packages/timewarp.fixie/index.md): The TimeWarp Fixie testing convention
- [timewarp-heroicons](https://timewarp.software/packages/timewarp-heroicons/index.md): All of the Tailwind HeroIcons wrapped as Blazor components.
- [TimeWarp.Jaribu](https://timewarp.software/packages/timewarp.jaribu/index.md): Lightweight testing helpers for single-file C# programs and scripts. Jaribu (Swahili: test/trial) provides TestRunner pattern and assertion helpers for executable .cs files.
- [TimeWarp.SourceGenerators](https://timewarp.software/packages/timewarp.sourcegenerators/index.md): Package Description
- [TimeWarp.Cli](https://timewarp.software/packages/timewarp.cli/index.md): Fluent API for elegant C# scripting with pipeline support
- [TimeWarp.Nuru.DevCli](https://timewarp.software/packages/timewarp.nuru.devcli/index.md): Reusable dev-cli endpoints for TimeWarp repositories - clean, self-install, check-version
- [TimeWarp.Multiavatar](https://timewarp.software/packages/timewarp.multiavatar/index.md): A .NET library for generating unique, deterministic avatars from any text input. Creates beautiful SVG avatars with 48 billion unique variations based on SHA256 hashing.
- [TimeWarp.OptionsValidation](https://timewarp.software/packages/timewarp.optionsvalidation/index.md): Integrates FluentValidation with Microsoft.Extensions.Options for configuration validation at startup.
- [TimeWarp.Amuru.Tools](https://timewarp.software/packages/timewarp.amuru.tools/index.md): Fluent builders for common CLI tools (dotnet, git, fzf) plus TimeWarp repo services, built on TimeWarp.Amuru
- [TimeWarp.Foundation.Domain](https://timewarp.software/packages/timewarp.foundation.domain/index.md): Domain primitives (Enumeration, Entity<TId>, IAggregateRoot) for the TimeWarp foundation layer. Dependency-free.
- [TimeWarp.Nuru.Search](https://timewarp.software/packages/timewarp.nuru.search/index.md): CLI search tool for indexing and searching Nuru CLI endpoints across multiple CLIs
- [TimeWarp.Modules](https://timewarp.software/packages/timewarp.modules/index.md): Lightweight IModule composition abstraction used by the TimeWarp foundation layer.
- [TimeWarp.QuickBooks](https://timewarp.software/packages/timewarp.quickbooks/index.md): QuickBooks Online API integration with OAuth authentication and data access capabilities.
- [TimeWarp.Foundation.Contracts](https://timewarp.software/packages/timewarp.foundation.contracts/index.md): Shared contracts, request/response markers, route/auth/query source generator, and common types for the TimeWarp foundation layer.
- [TimeWarp.Foundation.Application](https://timewarp.software/packages/timewarp.foundation.application/index.md): Application-layer abstractions and TimeWarp.Mediator pipeline behaviors for the TimeWarp foundation layer.
- [TimeWarp.Foundation.Infrastructure](https://timewarp.software/packages/timewarp.foundation.infrastructure/index.md): Infrastructure services (date-time, current-user) and aggregate EF persistence (AggregateDbContext) for the TimeWarp foundation layer.
- [TimeWarp.Foundation.Server](https://timewarp.software/packages/timewarp.foundation.server/index.md): ASP.NET server building blocks (modules, base endpoints, CORS, service discovery) for the TimeWarp foundation layer.
- [TimeWarpRooTools](https://timewarp.software/packages/timewarprootools/index.md): TimeWarp Roo Code Tools
- [TimeWarp.Architecture.Analyzers](https://timewarp.software/packages/timewarp.architecture.analyzers/index.md): Roslyn convention analyzers for TimeWarp Architecture (TWA0002–0016, TWA0020–0024). Analyzer-only package; safe to reference from every project including contracts.
- [TimeWarp.Architecture.Generators](https://timewarp.software/packages/timewarp.architecture.generators/index.md): Roslyn source generators and diagnostics for TimeWarp Architecture (FastEndpoint, Page, StateAccess, mock-factory registry, TypedId, ingress route prefixes) — TWA0001 and TWA0017/0018/0019. Analyzer-o…
- [TimeWarp.Jaribu.TestingPlatform](https://timewarp.software/packages/timewarp.jaribu.testingplatform/index.md): Microsoft.Testing.Platform adapter for TimeWarp.Jaribu test framework
- [TimeWarp.Architecture.Attributes](https://timewarp.software/packages/timewarp.architecture.attributes/index.md): Runtime marker attributes for TimeWarp Architecture generators (e.g. [ApiEndpoint], [assembly: ApiEndpointsEmbedded]) and convention opt-outs ([TypeStemIdentifier]). Public library — not a private dep…
- [TimeWarp.Components](https://timewarp.software/packages/timewarp.components/index.md): Style-agnostic Blazor base components (DisplayComponent/ParentComponent, IAttributeComponent/IParentComponent) and CssBuilder. No state dependency.
- [TimeWarp.Identity](https://timewarp.software/packages/timewarp.identity/index.md): Principal identity (passkeys, agent keys, Entra-linked credentials, sessions/tokens, trust tiers) for TimeWarp applications.
- [TimeWarp.Mediator.Generators](https://timewarp.software/packages/timewarp.mediator.generators/index.md): Source generator for TimeWarp.Mediator: builds the message graph at compile time and emits a sealed, reflection-free, AOT-friendly IMediator plus per-scope ISender<TScope>/IPublisher<TScope> named pip…
- [TimeWarp.Mediator.Analyzers](https://timewarp.software/packages/timewarp.mediator.analyzers/index.md): Roslyn analyzers for TimeWarp.Mediator message graphs: TWM001 (request with no handler), TWM002 (duplicate handler), TWM003 (scope mismatch), TWM004 (wrong-scope send). Already bundled in TimeWarp.Med…
- [TimeWarp.402](https://timewarp.software/packages/timewarp.402/index.md): Internet-native x402 payment (challenge, verify, settle, credits) for TimeWarp applications.
- [TimeWarp.Flexbox](https://timewarp.software/packages/timewarp.flexbox/index.md): A pure C# implementation of the Flexbox layout algorithm for .NET applications
- [TimeWarp.Skills](https://timewarp.software/packages/timewarp.skills/index.md): CLI for managing agent skill sources and syncing them to harness skill directories.
- [TimeWarp.Terminal.Layout](https://timewarp.software/packages/timewarp.terminal.layout/index.md): Flexbox-composed terminal layouts for TimeWarp.Terminal widgets
- [TimeWarp.State.Telemetry](https://timewarp.software/packages/timewarp.state.telemetry/index.md): OpenTelemetry instrumentation for the TimeWarp.State mediator pipeline: action spans, timing, and opt-in AOT-safe state snapshots.
- [TimeWarp.State.Blazor](https://timewarp.software/packages/timewarp.state.blazor/index.md): Blazor components, JavaScript interop, and render subscriptions for TimeWarp.State.
- [TimeWarp.State.DevTools.Export](https://timewarp.software/packages/timewarp.state.devtools.export/index.md): Dev-only exporter that copies TimeWarp.State activity spans to the DevTools inspector. Not a production dependency.
- [TimeWarp.State.DevTools.Hosting](https://timewarp.software/packages/timewarp.state.devtools.hosting/index.md): Aspire hosting integration that adds the TimeWarp.State DevTools app and links it from the dashboard.

## Package Families

- [timewarp-state](https://timewarp.software/projects/timewarp-state/index.md): 7 packages from https://github.com/TimeWarpEngineering/timewarp-state
- [timewarp-nuru](https://timewarp.software/projects/timewarp-nuru/index.md): 5 packages from https://github.com/TimeWarpEngineering/timewarp-nuru
- [timewarp-mediator](https://timewarp.software/projects/timewarp-mediator/index.md): 4 packages from https://github.com/TimeWarpEngineering/timewarp-mediator
- [timewarp-architecture](https://timewarp.software/projects/timewarp-architecture/index.md): 12 packages from https://github.com/TimeWarpEngineering/timewarp-architecture
- [timewarp-amuru](https://timewarp.software/projects/timewarp-amuru/index.md): 3 packages from https://github.com/TimeWarpEngineering/timewarp-amuru
- [timewarp-terminal](https://timewarp.software/projects/timewarp-terminal/index.md): 2 packages from https://github.com/TimeWarpEngineering/timewarp-terminal
- [timewarp-jaribu](https://timewarp.software/projects/timewarp-jaribu/index.md): 2 packages from https://github.com/TimeWarpEngineering/timewarp-jaribu

## Agent Skills

- Install with [TimeWarp.Skills](https://timewarp.software/packages/timewarp.skills/index.md): `dnx TimeWarp.Skills -- add <name> https://timewarp.software/`

- [amuru](https://timewarp.software/skills/amuru/SKILL.md): Use TimeWarp.Amuru for process execution instead of System.Diagnostics.Process
- [flexbox](https://timewarp.software/skills/flexbox/SKILL.md): TimeWarp.Flexbox library - compute CSS flexbox layouts (positions and sizes) in pure C# with no UI framework; a Native AOT-safe port of Facebook's Yoga engine. Use for laying out boxes/nodes in canvases, terminals, games, PDF/image generation, or custom renderers - anywhere you need flex-direction, flex-grow, wrap, gap, align/justify, percentages, or absolute positioning computed for you.
- [terminal](https://timewarp.software/skills/terminal/SKILL.md): TimeWarp.Terminal library - console abstractions (IConsole, ITerminal), widgets (panels, tables, rules), ANSI colors, hyperlinks, and Unicode width handling for testable C# console apps
- [tw-aggregate-pattern](https://timewarp.software/skills/tw-aggregate-pattern/SKILL.md): **TIMEWARP SKILL** — the golden aggregate-root pattern: typed id, `Entity<TId>` base, fail-closed `Create`, named mutations with no public setters, a private nested `Invariants` validator, and save-time enforcement via `DomainInvariantsGuard`/`AggregateDbContext`. Invoke before adding or reviewing an `IAggregateRoot`, or when TWA0011/TWA0012 fire. WHEN: add an aggregate, IAggregateRoot, aggregate root, TWA0011, TWA0012, Invariants validator, typed id.
- [tw-blazor](https://timewarp.software/skills/tw-blazor/SKILL.md): Razor file authoring — one @code at the top, markup, optional <style> last. Use when creating or editing .razor files, @code blocks, component event handlers (they only dispatch TimeWarp.State actions), or in-file <style> tags. CSS placement: tw-blazor-css-strategy. App shell: tw-blazor-layout.
- [tw-blazor-css-strategy](https://timewarp.software/skills/tw-blazor-css-strategy/SKILL.md): How to style Blazor + FluentUI components in this repo without Tailwind. CSS isolation for every component, global design tokens, a native-root anchor plus targeted ::deep for FluentUI light-DOM children, ::part() for shadow DOM, and a ban on <style> elements in components because prerender HTML-encodes them. Use when authoring or restyling any .razor component, choosing where CSS lives, styling a FluentUI component, or fixing a first-paint style flash.
- [tw-blazor-layout](https://timewarp.software/skills/tw-blazor-layout/SKILL.md): How to structure Blazor app chrome with the "empty layout + cascaded page-component shell" pattern — keep LayoutComponentBase empty and put header/nav/content/aside/footer in ONE shell component that pages wrap their content in and that cascades itself. Use when designing a Blazor app's layout/navigation, deciding where chrome belongs, building a layout shell, or when chrome must react to a state store or per-navigation lifecycle that a layout can't provide.
- [tw-cli-search](https://timewarp.software/skills/tw-cli-search/SKILL.md): Search for CLI commands and tools installed on your system. Use when you need to find specific functionality, discover available commands, or explore what CLI tools are available.
- [tw-deploy](https://timewarp.software/skills/tw-deploy/SKILL.md): **TIMEWARP SKILL** — deploy a generated app from its Aspire AppHost: the target matrix (Docker Compose, Kubernetes/Helm, Azure: AKS or Azure Container Apps), `aspire publish` / `aspire deploy` per target, operator-run `dev deploy` / `dev deprovision` / `dev open` / `dev deploy migrate` (never CI), a local kind recipe, production-safety rules, secrets and parameters, Postgres migrations per target, the ingress topology, and container-runtime neutrality. Invoke before deploying, before adding a publish target, or before touching publish-mode wiring in the AppHost. WHEN: deploy the app, dev deploy, dev deprovision, dev open, dev deploy migrate, open the deployed app, migrate the deployed database, tear down a deployment, kind cluster, aspire publish, aspire deploy, docker compose, Helm chart, Kubernetes, AKS, Azure, Azure Container Apps, ACA, Flexible Server, Key Vault purge, production secrets, run migrations in production, ingress controller, Podman.
- [tw-feature-placement](https://timewarp.software/skills/tw-feature-placement/SKILL.md): **TIMEWARP SKILL** — feature-cohesive folder placement, per-use-case folders, and the filename grammar `<name>[-<function>]-<layer>.cs` for product code under `<family>/features/` and platform clusters under `<family>/platform/` (family-generic: web, api, grpc all share this machinery — worked examples below use web): which layer a file belongs to, what to name it and which folder it goes in, the registry that backs TWA0015/TWA0016, and the membership-guard build errors. Invoke before creating, moving, or renaming a file under a feature slice or platform cluster, or when a TWA0015/TWA0016/membership-guard error appears. WHEN: Where does this handler file go?, What do I name this contract file?, Should this file get its own folder?, TWA0015, TWA0016, feature file matches no registered layer suffix, platform/postgres, add a function segment to the registry, split a module into its own assembly.
- [tw-jaribu](https://timewarp.software/skills/tw-jaribu/SKILL.md): Write tests using the Jaribu framework for .NET 10 file-based apps (runfiles)
- [tw-mediator](https://timewarp.software/skills/tw-mediator/SKILL.md): Add and use TimeWarp.Mediator - in-process request/response and notifications for .NET with a source-generated, trim and NativeAOT safe dispatcher beside the MediatR-fork reflection one. Use when adding TimeWarp.Mediator to a project, writing requests, handlers, notifications or pipeline behaviors, choosing the generated (AddGeneratedMediator) or reflection (AddMediator) dispatcher, setting up named pipelines (ISender<TScope>), or fixing TWM001-TWM011 diagnostics.
- [tw-mock-response-factory](https://timewarp.software/skills/tw-mock-response-factory/SKILL.md): Add GetMockResponseFactory to API contracts and register factories in the SPA mock API service.
- [tw-nuru](https://timewarp.software/skills/tw-nuru/SKILL.md): Build CLI applications with TimeWarp.Nuru - a .NET route-based CLI framework with web-style routing, source generators, and AOT support. Use when creating CLI tools, defining commands/queries, adding parameters or options, testing CLI output, or working with TimeWarp.Nuru.
- [tw-slice-isolation](https://timewarp.software/skills/tw-slice-isolation/SKILL.md): **TIMEWARP SKILL** — product slice placement and TWA0009 isolation (SliceRoot, namespaces, platform Applications, Components/contracts sharing, CrossSliceReference opt-out). Invoke before scaffolding a new feature/slice/page or when fixing TWA0009 / cross-slice references. WHEN: Add a new clients feature page, Where does this state live?, TWA0009 slice references another product slice, CrossSliceReference, new product area under features/, greenfield slice scaffolding.
- [tw-web-api-contracts](https://timewarp.software/skills/tw-web-api-contracts/SKILL.md): **TIMEWARP SKILL** — endpoint-centric Web.Contracts API contracts (Command, Query, ApiRoute, I*Details, Validator, serialization tests). Invoke before scaffolding or fixing contracts. WHEN: Add a CreateTodoItem command contract, Scaffold a GetRole query with ApiRoute and IRoleDetails for the edit form, Add a serialization round-trip test for my Command.

## Optional

- [Package catalog (JSON)](https://timewarp.software/packages/index.json): machine-readable list of all packages and families
- [Voluntary tip endpoint](https://timewarp.software/api/tip): optional x402 tip ($0.10 USDC on Base, 1000 sats Lightning, or 1 ADA on Cardano via cardano402.com when offered); Lightning Address tip@timewarp.software; free docs at /tip/; may 402 only here when tips enabled
- [GitHub organization](https://github.com/TimeWarpEngineering): source repositories
- [NuGet profile](https://www.nuget.org/profiles/TimeWarp.Enterprises): published packages
- [TimeWarp Enterprises LLC](https://timewarp.enterprises/): the company behind TimeWarp Engineering