Shared design package

@molarverse/pq-design supplies the flat mono tokens, CSS and React controls used by PQSetup. Its source, CI and releases live in the public PQDesign repository. PQViewer and PQEnalyzer Web install the same versioned package without a sibling checkout.

Install in a web frontend

From the consumer’s frontend directory:

npm install "https://github.com/MolarVerse/PQDesign/releases/download/v0.1.3/molarverse-pq-design-0.1.3.tgz"

Commit package.json and package-lock.json. npm ci then installs the same package version in CI and on another machine. React 19 and Lucide are peer dependencies; the consuming app supplies them.

Choose the import that matches the UI:

• For shared React controls, import styles.css before the app’s layout CSS. It includes tokens, base styles, and component rules.

• For an app with its own controls, import only tokens.css. For example, PQViewer keeps its viewer dialogs and toolbars while using the common palette. The full stylesheet has unscoped class selectors such as .command-palette and .notice that can affect unrelated components with the same names.

// App using shared controls, such as PQEnalyzer Web
import "@molarverse/pq-design/styles.css";
import { Field, Modal } from "@molarverse/pq-design";

// App using its own controls, such as PQViewer
import "@molarverse/pq-design/tokens.css";
import "./viewer.css";

Keep product-specific layout rules in the consuming app. tokens.json is also exported for non-CSS consumers. The CSS font stack prefers IBM Plex Mono; apps that need that exact face must supply its font files.

Terminal

The Python application bundles unchanged copies of python/pq_terminal.py and tokens.json from the same archive. pqsetup/_terminal.py supplies the app name, version and palette. Rich and rich-argparse provide terminal rendering and help; server actions use standard Python logging.

CI compares these assets with the installed design package. Change the shared renderer in PQDesign, then update the archive URL, lockfile and Python copies together.

Change the shared design

Edit the PQDesign repository. tokens.json is the source for the generated CSS. Reusable React controls and their styles live there too. Build and test from that checkout:

npm ci
npm run tokens
npm test
npm run build

Changes to exported components, tokens or public class names require a design package version bump. Tag the verified commit v<version> in PQDesign to build the installable archive and its checksums. Consumer repositories then update the archive URL and lockfile together. PQSetup’s Python release number is separate from the design package version.