@epikodelabs/testify 1.0.16 → 1.0.17

package/README.md

@@ -2,27 +2,61 @@
 
 A flexible test runner for Jasmine that supports multiple execution environments with built-in TypeScript compilation, hot module reloading, and code coverage.
 
-## Features
+> “**testify** doesn’t mock the browser. It invites the browser into the courtroom and asks it to testify under oath.”
 
-- **Multiple Execution Environments**
-  - Real browsers (Chrome, Firefox, Safari) for DOM and browser API testing
-  - Headless browsers for CI/CD pipelines
-  - Node.js for fastest unit test execution
-  
-- **Developer Experience**
-  - Hot Module Reload (HMR) for instant test feedback
-  - TypeScript compilation with source maps
-  - Interactive browser-based test reporter
-  - VS Code debug integration
-  
-- **Testing Capabilities**
-  - Istanbul code coverage reporting
-  - Configurable test execution order and randomization
-  - Cross-environment test compatibility
+<p align="center">
+  <a href="https://github.com/epikodelabs/testify/actions/workflows/build.yml">
+    <img src="https://github.com/epikodelabs/testify/actions/workflows/build.yml/badge.svg?branch=main" alt="Build Status">
+  </a>
+  <a href="https://www.npmjs.com/package/@epikodelabs/testify">
+    <img src="https://img.shields.io/npm/v/@epikodelabs/testify.svg?style=flat-square" alt="NPM Version">
+  </a>
+  <a href="https://www.npmjs.com/package/@epikodelabs/testify">
+    <img src="https://img.shields.io/npm/dm/@epikodelabs/testify.svg?style=flat-square" alt="NPM Downloads">
+  </a>
+</p>
+
+## Give a Star on GitHub
+
+If testify helps you, please give it a star: https://github.com/epikodelabs/testify
 
 ---
 
-## Installation
+## ✨ Why testify
+
+**testify** is a modern test runner built for Jasmine that bridges the gap between fast unit testing and real browser testing. Whether you need blazing-fast feedback loops in Node.js or full DOM testing in actual browsers (yes, *actual* browsers—not JSDOM pretending to be one), testify adapts to your workflow with hot module reloading, TypeScript-first design, and zero-config coverage reporting. It's like having a Swiss Army knife for testing, except it actually works and won't get confiscated at the airport.
+
+### Highlights
+
+- 🌐 Real browsers (Chrome, Firefox, Safari) for DOM and browser API testing
+- ⚡ Node.js execution for lightning-fast unit tests
+- 🔥 Hot Module Reload for instant test feedback during development
+- 📦 TypeScript compilation with source maps out of the box
+- 📊 Istanbul code coverage with beautiful HTML reports
+- 🎯 Interactive browser-based test reporter
+- 🔧 VS Code debug integration for single-spec debugging
+
+### Why "testify"?
+
+Look, we'll be honest. Coming up with a testing library name in 2025 is like trying to find a good username on Twitter in 2010. Everything's taken. We considered:
+
+- `test-runner` - Too generic (also taken)
+- `jasmine-tester` - Too obvious (also taken)
+- `vite-jasmine-runner` - Too long (and, you guessed it, taken)
+- `super-mega-awesome-test-framework` - Too humble
+
+So we landed on `testify` because:
+1. Your tests should be able to testify about your code in court 🧑‍⚖️
+2. It sounds vaguely spiritual, which you'll need when debugging flaky tests 🙏
+3. The npm package name was actually available 🎉
+4. It has the word "test" in it (we're nothing if not literal)
+
+> **⚖️ The testify Promise**  
+> *testify doesn't mock the browser. It invites the browser into the courtroom and asks it to testify under oath.*
+
+---
+
+## 📦 Installation
 
 ```bash
 # Install the test runner
@@ -34,9 +68,9 @@ npx playwright install
 
 ---
 
-## Quick Start
+## ⚡️ Quick start
 
-### 1. Initialize Configuration
+### 1. Initialize configuration
 
 ```bash
 npx testify init
@@ -56,7 +90,7 @@ This creates `testify.json` with sensible defaults:
 }
 ```
 
-### 2. Write Jasmine Tests
+### 2. Write Jasmine tests
 
 Create `.spec.ts` files in your test directory:
 
@@ -83,7 +117,7 @@ describe('Calculator', () => {
 });
 ```
 
-### 3. Run Your Tests
+### 3. Run your tests
 
 ```bash
 # Development: Interactive browser mode
@@ -104,11 +138,11 @@ npx testify --watch
 
 ---
 
-## Execution Modes
+## 🎯 Execution modes
 
-### Browser Mode (Default)
+### 🌐 Browser mode (Default)
 
-**Best for:** Development and debugging
+**Best for:** Development and debugging (and feeling like a real developer)
 
 ```bash
 npx testify
@@ -116,12 +150,13 @@ npx testify
 
 - Opens `http://localhost:8888` in your default browser
 - Interactive HTML test reporter with Jasmine UI
-- Full browser DevTools for debugging
+- Full browser DevTools for debugging (F12 is your friend)
 - Access to DOM, localStorage, fetch, and all browser APIs
+- Watch your tests fail in glorious 1080p
 
-### Headless Browser Mode
+### 🤖 Headless browser mode
 
-**Best for:** CI/CD and automated testing
+**Best for:** CI/CD and automated testing (robots don't need screens)
 
 ```bash
 # Chrome (default)
@@ -130,27 +165,29 @@ npx testify --headless
 # Firefox
 npx testify --headless --browser firefox
 
-# Safari/WebKit
+# Safari/WebKit (for the brave)
 npx testify --headless --browser webkit
 ```
 
-- Runs real browser without UI
+- Runs real browser without UI (like a browser in witness protection)
 - Full browser API support
 - Console output with test results
 - Excellent for cross-browser testing
+- No awkward eye contact with DevTools
 
-### Node.js Mode
+### ⚡ Node.js mode
 
-**Best for:** Fast unit testing
+**Best for:** Fast unit testing (when you just want to go home early)
 
 ```bash
 npx testify --headless --browser node
 ```
 
-- Fastest execution (no browser startup overhead)
+- Fastest execution (no browser startup overhead—just pure speed)
 - Limited to Node.js APIs only
-- Perfect for pure TypeScript logic
+- Perfect for pure TypeScript logic that doesn't need a browser's emotional support
 - No DOM or browser-specific APIs
+- Your tests run so fast you'll think they're not even running (they are, we promise)
 
 **Suppress console output:**
 ```bash
@@ -167,25 +204,26 @@ npx testify --headless --browser node --quiet
 TS_TEST_RUNNER_SUPPRESS_CONSOLE_LOGS=1 npx testify --headless --browser node
 ```
 
-### Watch Mode
+### 🔥 Watch mode
 
-**Best for:** Rapid development iteration
+**Best for:** Rapid development iteration (and existential dread watching tests fail in real-time)
 
 ```bash
 npx testify --watch
 ```
 
-- Hot Module Reload for instant feedback
-- Watches source and test files for changes
+- Hot Module Reload for instant feedback (faster than your morning coffee)
+- Watches source and test files for changes (like a very attentive guard dog)
 - Automatically re-runs affected tests
 - Only works in headed browser mode
 - WebSocket-based synchronization
+- Warning: May cause productivity addiction
 
-**Important:** Watch mode cannot be combined with `--headless` or `--coverage`.
+**Important:** Watch mode cannot be combined with `--headless` or `--coverage`. (We tried. The universe said no.)
 
 ---
 
-## Code Coverage
+## 📊 Code coverage
 
 Enable Istanbul code coverage with the `--coverage` flag:
 
@@ -207,122 +245,9 @@ npx testify --coverage
 
 ---
 
-## Configuration Reference
-
-### Configuration File: `testify.json`
-
-```json
-{
-  // Source and test directories
-  "srcDirs": ["./src/lib"],
-  "testDirs": ["./src/tests"],
-  "exclude": ["**/node_modules/**", "**/.git/**"],
-  
-  // Build output
-  "outDir": "./dist/.vite-jasmine-build",
-  "preserveOutputs": false,
-  
-  // Execution settings
-  "browser": "chrome",
-  "headless": false,
-  "port": 8888,
-  "coverage": false,
-  "watch": false,
-  "suppressConsoleLogs": false,
-  
-  // TypeScript configuration
-  "tsconfig": "tsconfig.json",
-  
-  // Jasmine configuration
-  "jasmineConfig": {
-    "env": {
-      "random": true,
-      "seed": 0,
-      "timeout": 120000,
-      "stopSpecOnExpectationFailure": false
-    }
-  },
-  
-  // HTML page customization
-  "htmlOptions": {
-    "title": "My Project Tests"
-  },
-  
-  // Vite build options
-  "viteBuildOptions": {
-    "target": "es2022",
-    "sourcemap": true,
-    "minify": false
-  }
-}
-```
-
-### Configuration Options
-
-| Option | Type | Default | Description |
-|--------|------|---------|-------------|
-| `srcDirs` | `string[]` | `["./src"]` | Source code directories |
-| `testDirs` | `string[]` | `["./tests"]` | Test file directories |
-| `exclude` | `string[]` | `["**/node_modules/**"]` | Patterns to exclude |
-| `outDir` | `string` | `"./dist/.vite-jasmine-build"` | Build output directory |
-| `browser` | `string` | `"chrome"` | Browser to use: `chrome`, `firefox`, `webkit`, `node` |
-| `headless` | `boolean` | `false` | Run in headless mode |
-| `port` | `number` | `8888` | Development server port |
-| `coverage` | `boolean` | `false` | Enable code coverage |
-| `watch` | `boolean` | `false` | Enable watch mode with HMR |
-| `suppressConsoleLogs` | `boolean` | `false` | Hide spec-level console output in Node mode |
-| `preserveOutputs` | `boolean` | `false` | Skip regenerating outputs when they exist |
-
----
-
-## Command Line Reference
+## 🧪 Environment-specific testing
 
-### Basic Commands
-
-| Command | Description |
-|---------|-------------|
-| `npx testify` | Run in browser (development mode) |
-| `npx testify init` | Create configuration file |
-| `npx testify --help` | Show help message |
-
-### Execution Flags
-
-| Flag | Description |
-|------|-------------|
-| `--headless` | Run in headless mode |
-| `--browser <n>` | Choose browser: `chrome`, `firefox`, `webkit`, `node` |
-| `--watch` | Enable watch mode with HMR |
-| `--coverage` | Generate code coverage reports |
-| `--seed <number>` | Set randomization seed |
-| `--silent` / `--quiet` | Suppress console logs (Node mode only) |
-| `--preserve` | Skip regenerating outputs when they exist |
-| `--config <path>` | Use custom config file |
-
-### Examples
-
-```bash
-# Development workflow
-npx testify --watch
-
-# CI/CD pipeline
-npx testify --headless --coverage
-
-# Cross-browser testing
-npx testify --headless --browser firefox
-npx testify --headless --browser webkit
-
-# Deterministic test order
-npx testify --seed 12345
-
-# Fast unit tests with clean console
-npx testify --headless --browser node --silent
-```
-
----
-
-## Environment-Specific Testing
-
-### Browser-Only Tests
+### Browser-only tests
 
 ```typescript
 describe('Browser APIs', () => {
@@ -350,7 +275,7 @@ describe('Browser APIs', () => {
 });
 ```
 
-### Node.js-Only Tests
+### Node.js-only tests
 
 ```typescript
 describe('Node.js APIs', () => {
@@ -373,7 +298,7 @@ describe('Node.js APIs', () => {
 });
 ```
 
-### Cross-Environment Tests
+### Cross-environment tests
 
 ```typescript
 describe('Universal Code', () => {
@@ -393,7 +318,7 @@ describe('Universal Code', () => {
 
 ---
 
-## Single Spec Runner (jasmine)
+## 🐛 Single spec runner (jasmine)
 
 Run a single spec file in Node.js using `jasmine-core`:
 
@@ -407,7 +332,7 @@ node --loader @epikodelabs/testify/esm-loader.mjs \
   --spec ./tests/example.spec.ts
 ```
 
-### VS Code Debug Configuration
+### VS Code debug configuration
 
 Create or update `.vscode/launch.json`:
 
@@ -438,7 +363,7 @@ Or manually add this configuration:
 
 **Important:** Do not point at `node_modules/.bin/jasmine` (shell shim). Always use the full path to the actual JS file.
 
-### jasmine Options
+### jasmine options
 
 ```bash
 npx jasmine --spec <path>        # Path to spec file
@@ -451,9 +376,9 @@ npx jasmine init                 # Create VS Code debug config
 
 ---
 
-## CI/CD Integration
+## 🚀 CI/CD integration
 
-### GitHub Actions Example
+### GitHub Actions example
 
 ```yaml
 name: Tests
@@ -490,131 +415,181 @@ jobs:
           files: ./coverage/lcov.info
 ```
 
-### Performance Comparison
+### Performance comparison
 
 | Environment | Speed | Browser APIs | Use Case |
 |-------------|-------|-------------|----------|
-| Node.js | ⚡ Fastest | ❌ None | Unit tests, pure logic |
-| Headless Chrome | 🐌 Medium | ✅ Full | Integration tests, DOM |
-| Headless Firefox | 🐌 Medium | ✅ Full | Cross-browser testing |
-| Browser (headed) | 🐌 Slowest | ✅ Full + DevTools | Development, debugging |
+| Node.js | ⚡ Fastest (blink and you'll miss it) | ❌ None | Unit tests, pure logic |
+| Headless Chrome | 🐌 Medium (coffee break pace) | ✅ Full | Integration tests, DOM |
+| Headless Firefox | 🐌 Medium (also coffee break pace) | ✅ Full | Cross-browser testing |
+| Browser (headed) | 🐌 Slowest (full meal pace) | ✅ Full + DevTools | Development, debugging |
 
 ---
 
-## Project Structure
+## ⚖️ testify vs other test runners
 
-The test runner expects this structure (all paths are configurable):
+| Feature | testify | Jest | Vitest | Karma |
+|---------|---------|------|--------|-------|
+| Real browser testing | ✅ | ❌ | ❌ | ✅ |
+| Node.js execution | ✅ | ✅ | ✅ | ❌ |
+| Hot Module Reload | ✅ | ✅ | ✅ | ❌ |
+| TypeScript support | ✅ | ✅ | ✅ | ⚠️ Plugin |
+| Code coverage | ✅ | ✅ | ✅ | ✅ |
+| Setup complexity | Low | Medium | Low | High |
+| Jasmine framework | ✅ | ❌ | ❌ | ✅ |
+| Active maintenance | ✅ | ✅ | ✅ | ⚠️ Limited |
+| Name sounds like courtroom drama | ✅ | ❌ | ❌ | ⚠️ Kinda |
 
-```
-your-project/
-├── src/
-│   ├── lib/                         # Source code
-│   │   ├── calculator.ts
-│   │   └── utils.ts
-│   └── tests/                       # Test files
-│       ├── calculator.spec.ts
-│       └── utils.spec.ts
-├── dist/
-│   └── .vite-jasmine-build/         # Compiled output (auto-generated)
-│       ├── index.html
-│       ├── test-runner.js
-│       └── *.js
-├── coverage/                         # Coverage reports (auto-generated)
-│   ├── index.html
-│   └── lcov.info
-├── testify.json              # Configuration file
-└── tsconfig.json                    # TypeScript configuration
-```
+**Why choose testify:**
+- **vs Jest:** Better real browser testing support, actual browser environments (and our name is easier to spell)
+- **vs Vitest:** Established Jasmine ecosystem, simpler for existing Jasmine users (also, we tested our name—it works)
+- **vs Karma:** Modern tooling, TypeScript-first, simpler setup, active development (and way less karmic baggage)
 
 ---
 
-## Troubleshooting
-
-### Browser Not Found
+## 🔧 Configuration reference
 
-```bash
-# Install all browsers
-npx playwright install
-
-# Or install specific browser
-npx playwright install chrome
-npx playwright install firefox
-npx playwright install webkit
-```
-
-### Port Already in Use
-
-Change the port in `testify.json`:
+### Configuration file: `testify.json`
 
 ```json
 {
-  "port": 3000
+  // Source and test directories
+  "srcDirs": ["./src/lib"],
+  "testDirs": ["./src/tests"],
+  "exclude": ["**/node_modules/**", "**/.git/**"],
+  
+  // Build output
+  "outDir": "./dist/.vite-jasmine-build",
+  "preserveOutputs": false,
+  
+  // Execution settings
+  "browser": "chrome",
+  "headless": false,
+  "port": 8888,
+  "coverage": false,
+  "watch": false,
+  "suppressConsoleLogs": false,
+  
+  // TypeScript configuration
+  "tsconfig": "tsconfig.json",
+  
+  // Jasmine configuration
+  "jasmineConfig": {
+    "env": {
+      "random": true,
+      "seed": 0,
+      "timeout": 120000,
+      "stopSpecOnExpectationFailure": false
+    }
+  },
+  
+  // HTML page customization
+  "htmlOptions": {
+    "title": "My Project Tests"
+  },
+  
+  // Vite build options
+  "viteBuildOptions": {
+    "target": "es2022",
+    "sourcemap": true,
+    "minify": false
+  }
 }
 ```
 
-Or use a different port via command line:
+### Configuration options
 
-```bash
-# Note: Currently requires config file change
-# CLI port override coming in future version
-```
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `srcDirs` | `string[]` | `["./src"]` | Source code directories |
+| `testDirs` | `string[]` | `["./tests"]` | Test file directories |
+| `exclude` | `string[]` | `["**/node_modules/**"]` | Patterns to exclude |
+| `outDir` | `string` | `"./dist/.vite-jasmine-build"` | Build output directory |
+| `browser` | `string` | `"chrome"` | Browser to use: `chrome`, `firefox`, `webkit`, `node` |
+| `headless` | `boolean` | `false` | Run in headless mode |
+| `port` | `number` | `8888` | Development server port |
+| `coverage` | `boolean` | `false` | Enable code coverage |
+| `watch` | `boolean` | `false` | Enable watch mode with HMR |
+| `suppressConsoleLogs` | `boolean` | `false` | Hide spec-level console output in Node mode |
+| `preserveOutputs` | `boolean` | `false` | Skip regenerating outputs when they exist |
 
-### No Tests Found
+---
 
-Verify:
-- Test files are in the `testDirs` location
-- Files have `.spec.ts` or `.spec.js` extension
-- Tests use proper Jasmine syntax (`describe`, `it`, `expect`)
-- Directories are not in the `exclude` list
+## 📖 Command line reference
 
-### TypeScript Compilation Errors
+### Basic commands
 
-1. Check your `tsconfig.json` matches your project structure
-2. Ensure `tsconfig` path in `testify.json` is correct
-3. Verify path aliases are properly configured
-4. Check that all dependencies are installed
+| Command | Description |
+|---------|-------------|
+| `npx testify` | Run in browser (development mode) |
+| `npx testify init` | Create configuration file |
+| `npx testify --help` | Show help message |
 
-### Watch Mode Not Working
+### Execution flags
+
+| Flag | Description |
+|------|-------------|
+| `--headless` | Run in headless mode |
+| `--browser <n>` | Choose browser: `chrome`, `firefox`, `webkit`, `node` |
+| `--watch` | Enable watch mode with HMR |
+| `--coverage` | Generate code coverage reports |
+| `--seed <number>` | Set randomization seed |
+| `--silent` / `--quiet` | Suppress console logs (Node mode only) |
+| `--preserve` | Skip regenerating outputs when they exist |
+| `--config <path>` | Use custom config file |
 
-Remember:
-- Watch mode only works in headed browser mode
-- Cannot use with `--headless` flag
-- Cannot use with `--coverage` flag
-- Cannot use with `--browser node`
+### Examples
 
-### Coverage Reports Missing
+```bash
+# Development workflow
+npx testify --watch
 
-Ensure:
-- `--coverage` flag is used
-- Tests complete successfully
-- Output directory (`coverage/`) has write permissions
-- Not using `--watch` mode (coverage disabled in watch mode)
+# CI/CD pipeline
+npx testify --headless --coverage
+
+# Cross-browser testing
+npx testify --headless --browser firefox
+npx testify --headless --browser webkit
+
+# Deterministic test order
+npx testify --seed 12345
+
+# Fast unit tests with clean console
+npx testify --headless --browser node --silent
+```
 
 ---
 
-## Comparison with Other Test Runners
+## 📁 Project structure
 
-| Feature | testify | Jest | Vitest | Karma |
-|---------|---------------|------|--------|-------|
-| Real browser testing | ✅ | ❌ | ❌ | ✅ |
-| Node.js execution | ✅ | ✅ | ✅ | ❌ |
-| Hot Module Reload | ✅ | ✅ | ✅ | ❌ |
-| TypeScript support | ✅ | ✅ | ✅ | ⚠️ Plugin |
-| Code coverage | ✅ | ✅ | ✅ | ✅ |
-| Setup complexity | Low | Medium | Low | High |
-| Jasmine framework | ✅ | ❌ | ❌ | ✅ |
-| Active maintenance | ✅ | ✅ | ✅ | ⚠️ Limited |
+The test runner expects this structure (all paths are configurable):
 
-**Why choose testify:**
-- **vs Jest:** Better real browser testing support, actual browser environments
-- **vs Vitest:** Established Jasmine ecosystem, simpler for existing Jasmine users
-- **vs Karma:** Modern tooling, TypeScript-first, simpler setup, active development
+```
+your-project/
+├── src/
+│   ├── lib/                         # Source code
+│   │   ├── calculator.ts
+│   │   └── utils.ts
+│   └── tests/                       # Test files
+│       ├── calculator.spec.ts
+│       └── utils.spec.ts
+├── dist/
+│   └── .vite-jasmine-build/         # Compiled output (auto-generated)
+│       ├── index.html
+│       ├── test-runner.js
+│       └── *.js
+├── coverage/                         # Coverage reports (auto-generated)
+│   ├── index.html
+│   └── lcov.info
+├── testify.json                     # Configuration file
+└── tsconfig.json                    # TypeScript configuration
+```
 
 ---
 
-## Advanced Configuration
+## 🔧 Advanced configuration
 
-### Custom Vite Configuration
+### Custom Vite configuration
 
 You can extend the Vite configuration in `testify.json`:
 
@@ -631,7 +606,7 @@ You can extend the Vite configuration in `testify.json`:
 }
 ```
 
-### TypeScript Path Mapping
+### TypeScript path mapping
 
 Path aliases from `tsconfig.json` are automatically resolved:
 
@@ -648,7 +623,7 @@ Path aliases from `tsconfig.json` are automatically resolved:
 }
 ```
 
-### Multiple Source Directories
+### Multiple source directories
 
 ```json
 {
@@ -657,7 +632,7 @@ Path aliases from `tsconfig.json` are automatically resolved:
 }
 ```
 
-### Exclude Patterns
+### Exclude patterns
 
 ```json
 {
@@ -673,14 +648,92 @@ Path aliases from `tsconfig.json` are automatically resolved:
 
 ---
 
-## License
+## ❓ Troubleshooting
+
+### Browser not found
+
+Did you forget to invite the browsers to the party?
+
+```bash
+# Install all browsers (the whole squad)
+npx playwright install
+
+# Or install specific browser (selective guest list)
+npx playwright install chrome
+npx playwright install firefox
+npx playwright install webkit
+```
+
+### Port already in use
+
+Someone's camping on port 8888? Rude. Change the port in `testify.json`:
+
+```json
+{
+  "port": 3000
+}
+```
+
+Or use a different port via command line:
+
+```bash
+# Note: Currently requires config file change
+# CLI port override coming in future version
+# (We're working on it, okay? Rome wasn't built in a day)
+```
+
+### No tests found
+
+testify is looking for tests like a detective at a crime scene. Make sure:
+- Test files are in the `testDirs` location (it's not a treasure hunt)
+- Files have `.spec.ts` or `.spec.js` extension (naming conventions matter, people!)
+- Tests use proper Jasmine syntax (`describe`, `it`, `expect`) (no, `console.log` is not a test)
+- Directories are not in the `exclude` list (check if you accidentally ghosted your tests)
+
+### TypeScript compilation errors
+
+TypeScript is being picky again? Let's troubleshoot:
+
+1. Check your `tsconfig.json` matches your project structure (did you move files around and forget to tell TypeScript?)
+2. Ensure `tsconfig` path in `testify.json` is correct (typos happen to the best of us)
+3. Verify path aliases are properly configured (@ symbols need love too)
+4. Check that all dependencies are installed (did you `npm install`? Did you *really*?)
+
+### Watch mode not working
+
+Watch mode is like that one friend who only shows up under specific conditions:
+- Watch mode only works in headed browser mode (it likes to see what's happening)
+- Cannot use with `--headless` flag (it's shy without a UI)
+- Cannot use with `--coverage` flag (it can't multitask)
+- Cannot use with `--browser node` (needs a real browser, not a pretend one)
+
+### Coverage reports missing
+
+Coverage reports playing hide and seek? Make sure:
+- `--coverage` flag is used (it's not going to turn on itself)
+- Tests complete successfully (failed tests don't generate coverage, obviously)
+- Output directory (`coverage/`) has write permissions (is it read-only? That's a paddlin')
+- Not using `--watch` mode (coverage and watch mode are like oil and water—they don't mix)
+
+---
+
+## 📜 License
 
 MIT © 2025
 
 ---
 
-## Support
+## 🤝 Support
 
 - **Issues:** [GitHub Issues](https://github.com/epikodelabs/testify/issues)
 - **Documentation:** [GitHub Wiki](https://github.com/epikodelabs/testify/wiki)
-- **Changelog:** [CHANGELOG.md](./CHANGELOG.md)
+- **Changelog:** [CHANGELOG.md](./CHANGELOG.md)
+
+---
+
+<p align="center">
+  <strong>Get started</strong><br>
+  <a href="https://www.npmjs.com/package/@epikodelabs/testify">Install from NPM</a> •
+  <a href="https://github.com/epikodelabs/testify">View on GitHub</a> •
+  <a href="https://forms.gle/YOUR_FEEDBACK_FORM_ID">Give Feedback</a>
+</p>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epikodelabs/testify",
-  "version": "1.0.16",
+  "version": "1.0.17",
   "description": "Serve and run your Jasmine specs in a browser",
   "type": "module",
   "bin": {