# How to Run Tests for the Hallmark Project > Learn how to run tests for the Hallmark project. This guide explains the manual inspection process for validating UI against specifications. Get started with npm run serve. - Repository: [Hassan El Mghari/hallmark](https://github.com/Nutlope/hallmark) - Tags: how-to-guide - Published: 2026-07-30 --- **The Hallmark repository does not ship with an automated test suite; instead, validation relies on manual inspection where you start a local server with `npm run serve` and compare the rendered UI against the specifications in [`skills/hallmark/references/slop-test.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/slop-test.md).** Hallmark is a design skill package tailored for AI coding assistants. According to the [`package.json`](https://github.com/Nutlope/hallmark/blob/main/package.json) source code, the project defines only a `serve` script and lists no external npm dependencies, which means there is no `npm test` command available. Testing is performed by running the development server and manually verifying that the output matches the criteria documented in the Slop Test reference file. ## Manual Testing Workflow Since Hallmark lacks a conventional unit-testing framework, follow this manual validation process to verify functionality. ### 1. Start the Development Server Clone the repository and launch the HTTP server defined in [`package.json`](https://github.com/Nutlope/hallmark/blob/main/package.json): ```bash git clone https://github.com/Nutlope/hallmark.git cd hallmark npm run serve ``` The `serve` script hosts the `site/` directory on `http://localhost:4173` (as configured in the npm scripts). Keep this terminal session open while testing. ### 2. Review the Slop Test Reference Open [`skills/hallmark/references/slop-test.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/slop-test.md) in your editor. This file contains the authoritative test scenarios, expected outputs, and pass/fail criteria that define correct behavior for the skill. ### 3. Validate Against the Local UI Navigate to `http://localhost:4173` in your browser to load [`site/index.html`](https://github.com/Nutlope/hallmark/blob/main/site/index.html). Compare the rendered interface against each scenario described in the Slop Test reference. Check that typography, layout, and interactive components (driven by [`site/js/main.js`](https://github.com/Nutlope/hallmark/blob/main/site/js/main.js)) match the documented expectations. ## Key Files for Test Validation Understanding these source files clarifies why the workflow is manual: - **[`package.json`](https://github.com/Nutlope/hallmark/blob/main/package.json)** – Confirms the absence of a `test` script and shows that `dependencies` is empty, indicating no testing framework like Jest or Mocha is configured. - **[`skills/hallmark/references/slop-test.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/slop-test.md)** – The specification document containing test cases intended for manual verification. - **[`site/index.html`](https://github.com/Nutlope/hallmark/blob/main/site/index.html)** – The entry point served by `npm run serve`; this is the UI you will inspect during testing. - **[`site/js/main.js`](https://github.com/Nutlope/hallmark/blob/main/site/js/main.js)** – Contains the logic that renders interactive elements; review this when determining why a test case passes or fails. ## Creating an Automated Test Harness If you require automated regression testing, you must build a custom harness. Since `npm run serve` exposes a standard HTTP endpoint, you can use **Playwright** or **Puppeteer** to launch a headless browser, navigate to `localhost:4173`, and assert against the DOM structure described in [`slop-test.md`](https://github.com/Nutlope/hallmark/blob/main/slop-test.md). However, note that the Hallmark repository provides no out-of-the-box configuration for automated testing, and the project maintainers intend for validation to follow the manual Slop Test workflow described above. ## Summary - Hallmark has no built-in `npm test` command or automated test runner. - The only available npm script is `serve`, which launches a development server on port 4173. - Testing is performed manually by comparing the rendered UI at `localhost:4173` against the specifications in [`skills/hallmark/references/slop-test.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/slop-test.md). - The project has zero external npm dependencies, so `npm install` is optional and does not add testing capabilities. - Automated testing requires building a custom harness using browser automation tools. ## Frequently Asked Questions ### Does Hallmark include unit tests? No. According to the source code in [`package.json`](https://github.com/Nutlope/hallmark/blob/main/package.json), there is no `test` script defined and no testing framework listed in the dependencies. The project relies entirely on the Slop Test reference file for manual validation. ### What is the Slop Test reference file? [`skills/hallmark/references/slop-test.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/slop-test.md) is a markdown document that defines test scenarios and expected outcomes for the Hallmark skill. It serves as the specification against which developers manually verify correct behavior when running the local server. ### Why is there no `npm test` script available? The repository is structured as a design skill for AI coding assistants rather than a traditional library. The [`package.json`](https://github.com/Nutlope/hallmark/blob/main/package.json) only includes a `serve` script to host the static site, reflecting the project's intent for visual and manual verification instead of automated unit testing. ### Can I add automated testing to the Hallmark project? Yes. While not provided by default, you can create a custom test suite using frameworks like Jest with `jsdom` or end-to-end tools like Playwright. You would run `npm run serve` to start the server, then write tests that assert the rendered HTML matches the criteria documented in [`skills/hallmark/references/slop-test.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/slop-test.md).