Skip to content
DSH Themes
Back to Learn
06Installation8 min readBeginner

GUIDE 02 · INSTALLATION

Install a Verified Release

Installation is a local profile mutation. Treat the catalog as evidence, the downloaded tgz as the object being authorized, and the previous exact state as your return path.

Last verified
Aug 15, 2026
Runtime
0.1.0-rc.6
Verified scope
  • Exact rc.6 compatibility lane
  • Whole-artifact SHA-256 verification
  • Single direct web-profile theme
On this page
  1. Complete the preflight first
  2. Use exact local inputs

Complete the preflight first

  1. 01

    Read the runtime version

    The current verified lane requires DSH 0.1.0-rc.6. Stop if the exact runtime or recorded fingerprints differ.

  2. 02

    Inspect the current web profile

    Record the existing direct @dsh-themes/* dependency and exact version. More than one direct package is a conflict to resolve before installing.

  3. 03

    Use the controlled release download

    Prepare the exact published tgz in a restricted local artifact directory. Do not authorize a similarly named file from another source.

  4. 04

    Verify the complete artifact SHA-256

    Match the downloaded bytes to the catalog artifact digest and integrity. A payload digest inside the manifest is a different scope.

  5. 05

    Prepare the previous exact artifact

    If a theme is already active, keep its verified package and identity available before removing it.

Use exact local inputs

bash
RUNNER=/absolute/path/to/dsh-theme-manager/scripts/run-dsh.mjs
node "$RUNNER" --version
node "$RUNNER" plugin --profile web list --json
node "$RUNNER" plugin --profile web add /absolute/path/to/verified-theme.tgz --save-exact
node "$RUNNER" --profile web --dump-config
Command shape only. Replace the path with the already verified absolute artifact path.
  1. Confirm the direct dependency uses the expected package name and exact version, never a range.
  2. Confirm only one direct package under the @dsh-themes/* scope is active in the web profile.
  3. Restart DSH after adding, removing, or switching the package.
  4. Open the real web UI and verify the expected theme or skin identity before discarding any rollback material.

Installation references

Browse verified releasesSelect a published version with controlled evidence.Switch and roll backPreserve and consume an exact rollback record.

Continue learning

Previous guideChoose a Theme or a Full SkinNext guideCompare Light and Dark Modes

Continue from the verified evidence

Compare published artifacts or return to the installation documentation.

ExploreDocs