Local-first

Build with the system, not around it.

DV Layer is distributed as verified local tarballs. Consumers commit the exact package artifacts they use, making every installation reproducible without a registry.

Local package workflow

The release directory is immutable; consumer repositories vendor only the packages they need.

  1. Prepare a verified release

    Run the complete local release process from the DV Layer checkout.

    Terminal
    pnpm release:prepare
  2. Vendor the selected tarballs

    Copy packages from the verified release into the consumer's frontend/vendor/ directory.

    package.json
    Use the verified release archive.
  3. Import the smallest useful surface

    The lite CSS bundle covers tokens, base styles, and components. Choose full only when responsive utilities are needed.

    Application entry
    import '@dv-layer/html/css/lite';
    import { Button } from '@dv-layer/react';

Choose the surface that fits.

All package APIs share the same semantic tokens and component metadata.

Storybook

Run the interactive component and foundations browser directly from the checkout.

Use agent documentation

Interactive docs: run pnpm storybook. Storybook is a native development tool and is intentionally not part of the Docker service.