@testspectra/cli 1.1.11-rc.5 → 1.1.12

package/dist/utils/__tests__/demo-state.test.js

@@ -0,0 +1,96 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import http from 'http';
+import { DemoStateManager } from '../demo-state.js';
+describe('DemoStateManager (cli/src/utils/demo-state.ts)', () => {
+    let tmpDir;
+    let testServer = null;
+    let testPort = 0;
+    beforeAll(async () => {
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'spectra-demo-state-test-'));
+        fs.mkdirSync(path.join(tmpDir, '.testspectra'), { recursive: true });
+        // Start a dummy HTTP server simulating a live demo web app
+        await new Promise((resolve) => {
+            testServer = http.createServer((_req, res) => {
+                res.writeHead(200, {
+                    'Content-Type': 'text/html',
+                    'X-TestSpectra-Demo': 'true',
+                });
+                res.end('<div id="app"></div>');
+            });
+            testServer.listen(0, '127.0.0.1', () => {
+                const addr = testServer?.address();
+                testPort = typeof addr === 'object' && addr !== null ? addr.port : 0;
+                resolve();
+            });
+        });
+    });
+    afterAll(async () => {
+        if (testServer) {
+            await new Promise((resolve) => testServer?.close(() => resolve()));
+        }
+        if (fs.existsSync(tmpDir)) {
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+        }
+    });
+    it('saves and removes demo server state in the target project dir', () => {
+        const state = {
+            pid: process.pid,
+            url: `http://127.0.0.1:${testPort}`,
+            port: testPort,
+            apiUrl: 'http://127.0.0.1:5200',
+            apiPort: 5200,
+            startedAt: Date.now(),
+        };
+        DemoStateManager.saveState(state, tmpDir);
+        const stateFilePath = path.join(tmpDir, '.testspectra', 'demo-server.json');
+        expect(fs.existsSync(stateFilePath)).toBe(true);
+        const saved = JSON.parse(fs.readFileSync(stateFilePath, 'utf-8'));
+        expect(saved.url).toBe(`http://127.0.0.1:${testPort}`);
+        expect(saved.port).toBe(testPort);
+        DemoStateManager.removeState(tmpDir);
+        expect(fs.existsSync(stateFilePath)).toBe(false);
+    });
+    it('probeServer returns true for an active responsive HTTP server', async () => {
+        const isLive = await DemoStateManager.probeServer(`http://127.0.0.1:${testPort}`);
+        expect(isLive).toBe(true);
+    });
+    it('probeServer returns false for an inactive/closed port', async () => {
+        // 65534 is unlikely to be listening
+        const isLive = await DemoStateManager.probeServer('http://127.0.0.1:65534', 200);
+        expect(isLive).toBe(false);
+    });
+    it('getActiveDemoServer returns the state when the server is alive', async () => {
+        const state = {
+            pid: process.pid,
+            url: `http://127.0.0.1:${testPort}`,
+            port: testPort,
+            apiUrl: 'http://127.0.0.1:5200',
+            apiPort: 5200,
+            startedAt: Date.now(),
+        };
+        DemoStateManager.saveState(state, tmpDir);
+        const active = await DemoStateManager.getActiveDemoServer(tmpDir);
+        expect(active).not.toBeNull();
+        expect(active?.url).toBe(`http://127.0.0.1:${testPort}`);
+        expect(active?.port).toBe(testPort);
+        DemoStateManager.removeState(tmpDir);
+    });
+    it('getActiveDemoServer cleans up stale state file and returns null when server is not running', async () => {
+        const state = {
+            pid: 99999999, // Dead PID
+            url: 'http://127.0.0.1:65533', // Closed port
+            port: 65533,
+            startedAt: Date.now(),
+        };
+        DemoStateManager.saveState(state, tmpDir);
+        const stateFilePath = path.join(tmpDir, '.testspectra', 'demo-server.json');
+        expect(fs.existsSync(stateFilePath)).toBe(true);
+        const active = await DemoStateManager.getActiveDemoServer(tmpDir);
+        expect(active).toBeNull();
+        // Stale file should be cleaned up automatically
+        expect(fs.existsSync(stateFilePath)).toBe(false);
+    });
+});

package/dist/utils/api-server.d.ts

@@ -1,4 +1,4 @@
-/** Port the self-hosted demo API server listens on (separate from the demo web app's 5173). */
+/** Port the self-hosted demo API server listens on (separate from the demo web app's 5180). */
 export declare const DEMO_API_PORT = 5200;
 /**
  * Standalone self-hosted REST API server for the demo apps, kept separate from `DemoServer` (the

package/dist/utils/api-server.js

@@ -1,5 +1,5 @@
 import http from 'http';
-/** Port the self-hosted demo API server listens on (separate from the demo web app's 5173). */
+/** Port the self-hosted demo API server listens on (separate from the demo web app's 5180). */
 export const DEMO_API_PORT = 5200;
 // Self-hosted dummy REST data for the demo app's API sections — keeps the ApiInterception and
 // ApiSeeding suites fully offline/deterministic instead of depending on an external service
@@ -74,7 +74,11 @@ export class DemoApiServer {
                     reject(err);
                 }
             });
-            this.server.listen(this.port, '0.0.0.0', () => {
+            // Bind dual-stack (no host) rather than IPv4-only `0.0.0.0`: an IPv4-only bind silently
+            // coexists with an IPv6-localhost squatter on the same port, so a conflict would go
+            // undetected and clients resolving `localhost` to `::1` would hit the foreign server.
+            // See DemoServer for the full explanation.
+            this.server.listen(this.port, () => {
                 const addr = this.server?.address();
                 const actualPort = typeof addr === 'object' && addr !== null ? addr.port : this.port;
                 resolve({ url: `http://localhost:${actualPort}`, port: actualPort });
@@ -82,7 +86,7 @@ export class DemoApiServer {
         });
     }
     handleApi(req, res, pathname) {
-        // The demo web app (port 5173) calls this server (port 5200) cross-origin. A wildcard origin
+        // The demo web app (port 5180) calls this server (port 5200) cross-origin. A wildcard origin
         // can't be combined with credentialed requests (Access-Control-Allow-Credentials), which
         // /api/me below needs to receive the session cookie seeded via Spectra.browser.setCookies() —
         // reflect the actual request Origin instead so both credentialed and simple requests work.

package/dist/utils/demo-server.d.ts

@@ -1,3 +1,5 @@
+/** Default static port for the demo web app (distinct from Vite's default 5173 to avoid collisions). */
+export declare const DEFAULT_DEMO_PORT = 5180;
 /**
  * Static file server for the demo web app bundle. Serves ONLY the web app — the self-hosted demo
  * REST API lives in a separate `DemoApiServer` (`cli/src/utils/api-server.ts`, port 5200) so the

package/dist/utils/demo-server.js

@@ -16,6 +16,8 @@ const MIME_TYPES = {
     '.woff2': 'font/woff2',
     '.ttf': 'font/ttf',
 };
+/** Default static port for the demo web app (distinct from Vite's default 5173 to avoid collisions). */
+export const DEFAULT_DEMO_PORT = 5180;
 /**
  * Static file server for the demo web app bundle. Serves ONLY the web app — the self-hosted demo
  * REST API lives in a separate `DemoApiServer` (`cli/src/utils/api-server.ts`, port 5200) so the
@@ -24,7 +26,7 @@ const MIME_TYPES = {
 export class DemoServer {
     server = null;
     port;
-    constructor(port = 5173) {
+    constructor(port = DEFAULT_DEMO_PORT) {
         this.port = port;
     }
     static resolveDemoDist() {
@@ -67,6 +69,7 @@ export class DemoServer {
                     res.writeHead(200, {
                         'Content-Type': contentType,
                         'Access-Control-Allow-Origin': '*',
+                        'X-TestSpectra-Demo': 'true',
                     });
                     res.end(content);
                 }
@@ -76,15 +79,25 @@ export class DemoServer {
                 }
             });
             this.server.on('error', (err) => {
-                if (err.code === 'EADDRINUSE') {
-                    // Port already in use (e.g. user already running server)
-                    resolve({ url: `http://localhost:${this.port}`, port: this.port });
+                if (err.code === 'EADDRINUSE' && this.port !== 0) {
+                    // If preferred port is in use by another process, fall back to an ephemeral free port
+                    this.server?.listen(0, () => {
+                        const addr = this.server?.address();
+                        const actualPort = typeof addr === 'object' && addr !== null ? addr.port : 0;
+                        resolve({ url: `http://localhost:${actualPort}`, port: actualPort });
+                    });
                 }
                 else {
                     reject(err);
                 }
             });
-            this.server.listen(this.port, '0.0.0.0', () => {
+            // Bind dual-stack (no host = `::` with IPv4-mapped fallback) — NOT `0.0.0.0`. Chromium
+            // resolves `localhost` to `::1` first, so an IPv4-only server is missed whenever anything
+            // else answers IPv6 localhost. Note this does NOT guarantee EADDRINUSE against such a
+            // squatter: with SO_REUSEADDR a wildcard bind can silently coexist with a specific-bound
+            // socket, so callers must always follow the returned URL (or request port 0) instead of
+            // assuming the requested port is really ours.
+            this.server.listen(this.port, () => {
                 const addr = this.server?.address();
                 const actualPort = typeof addr === 'object' && addr !== null ? addr.port : this.port;
                 resolve({ url: `http://localhost:${actualPort}`, port: actualPort });

package/dist/utils/demo-state.d.ts

@@ -0,0 +1,40 @@
+export interface DemoServerState {
+    pid: number;
+    url: string;
+    port: number;
+    apiUrl?: string;
+    apiPort?: number;
+    startedAt: number;
+}
+export declare class DemoStateManager {
+    private static readonly STATE_FILENAME;
+    /**
+     * Resolves the primary project directory from `cwd` by locating `spectra.config.*`
+     * or falling back to searching upward for an existing `.testspectra` directory.
+     */
+    static resolveProjectDir(cwd?: string): string;
+    /**
+     * Returns candidate file paths for the demo server state file,
+     * checking the project-level `.testspectra` directory first, followed by the global home directory.
+     */
+    static getStateFilePaths(cwd?: string): string[];
+    /**
+     * Persists the active demo server state to disk for cross-process / cross-terminal discovery.
+     */
+    static saveState(state: DemoServerState, cwd?: string): void;
+    /**
+     * Removes demo server state files when the demo server terminates.
+     */
+    static removeState(cwd?: string): void;
+    /**
+     * Probes an HTTP server URL with a short timeout to verify it is responsive
+     * and optionally serves the TestSpectra demo web app.
+     */
+    static probeServer(url: string, timeoutMs?: number): Promise<boolean>;
+    /**
+     * Discovers whether a demo server session is actively running.
+     * If a state file exists and the target server responds to probe, returns the state.
+     * Stale state files (where the server does not respond) are automatically cleaned up.
+     */
+    static getActiveDemoServer(cwd?: string): Promise<DemoServerState | null>;
+}

package/dist/utils/demo-state.js

@@ -0,0 +1,157 @@
+import fs from 'fs';
+import path from 'path';
+import http from 'http';
+import os from 'os';
+import { ConfigLoader } from '../config/loader.js';
+export class DemoStateManager {
+    static STATE_FILENAME = 'demo-server.json';
+    /**
+     * Resolves the primary project directory from `cwd` by locating `spectra.config.*`
+     * or falling back to searching upward for an existing `.testspectra` directory.
+     */
+    static resolveProjectDir(cwd = process.cwd()) {
+        const configFile = ConfigLoader.findConfigFile(cwd);
+        if (configFile) {
+            return path.dirname(configFile);
+        }
+        let cur = path.resolve(cwd);
+        while (true) {
+            if (fs.existsSync(path.join(cur, '.testspectra'))) {
+                return cur;
+            }
+            const parent = path.dirname(cur);
+            if (parent === cur)
+                break;
+            cur = parent;
+        }
+        return path.resolve(cwd);
+    }
+    /**
+     * Returns candidate file paths for the demo server state file,
+     * checking the project-level `.testspectra` directory first, followed by the global home directory.
+     */
+    static getStateFilePaths(cwd = process.cwd()) {
+        const projectDir = this.resolveProjectDir(cwd);
+        const paths = [path.join(projectDir, '.testspectra', this.STATE_FILENAME)];
+        const homeDir = os.homedir();
+        const globalPath = path.join(homeDir, '.testspectra', this.STATE_FILENAME);
+        if (!paths.includes(globalPath)) {
+            paths.push(globalPath);
+        }
+        return paths;
+    }
+    /**
+     * Persists the active demo server state to disk for cross-process / cross-terminal discovery.
+     */
+    static saveState(state, cwd = process.cwd()) {
+        const filePaths = this.getStateFilePaths(cwd);
+        const content = JSON.stringify(state, null, 2);
+        for (const filePath of filePaths) {
+            try {
+                const dir = path.dirname(filePath);
+                if (!fs.existsSync(dir)) {
+                    fs.mkdirSync(dir, { recursive: true });
+                }
+                fs.writeFileSync(filePath, content, 'utf-8');
+            }
+            catch {
+                // Best-effort write
+            }
+        }
+    }
+    /**
+     * Removes demo server state files when the demo server terminates.
+     */
+    static removeState(cwd = process.cwd()) {
+        const filePaths = this.getStateFilePaths(cwd);
+        for (const filePath of filePaths) {
+            try {
+                if (fs.existsSync(filePath)) {
+                    fs.unlinkSync(filePath);
+                }
+            }
+            catch {
+                // Best-effort removal
+            }
+        }
+    }
+    /**
+     * Probes an HTTP server URL with a short timeout to verify it is responsive
+     * and optionally serves the TestSpectra demo web app.
+     */
+    static async probeServer(url, timeoutMs = 1000) {
+        return new Promise((resolve) => {
+            try {
+                const parsed = new URL(url);
+                const req = http.get({
+                    hostname: parsed.hostname,
+                    port: parsed.port || (parsed.protocol === 'https:' ? 443 : 80),
+                    path: '/',
+                    timeout: timeoutMs,
+                    headers: {
+                        'User-Agent': 'TestSpectra-CLI-Probe',
+                    },
+                }, (res) => {
+                    // Confirm the server is responsive (status 200 or 3xx)
+                    const isOk = (res.statusCode && res.statusCode >= 200 && res.statusCode < 400) || false;
+                    res.resume(); // Drain stream
+                    resolve(isOk);
+                });
+                req.on('timeout', () => {
+                    req.destroy();
+                    resolve(false);
+                });
+                req.on('error', () => {
+                    resolve(false);
+                });
+            }
+            catch {
+                resolve(false);
+            }
+        });
+    }
+    /**
+     * Discovers whether a demo server session is actively running.
+     * If a state file exists and the target server responds to probe, returns the state.
+     * Stale state files (where the server does not respond) are automatically cleaned up.
+     */
+    static async getActiveDemoServer(cwd = process.cwd()) {
+        const filePaths = this.getStateFilePaths(cwd);
+        for (const filePath of filePaths) {
+            if (!fs.existsSync(filePath)) {
+                continue;
+            }
+            let parsed = null;
+            try {
+                const raw = fs.readFileSync(filePath, 'utf-8');
+                parsed = JSON.parse(raw);
+            }
+            catch {
+                // Corrupt file, clean it up
+                try {
+                    fs.unlinkSync(filePath);
+                }
+                catch { }
+                continue;
+            }
+            if (!parsed || !parsed.url || typeof parsed.port !== 'number') {
+                try {
+                    fs.unlinkSync(filePath);
+                }
+                catch { }
+                continue;
+            }
+            // Verify the server is actually responding
+            const isAlive = await this.probeServer(parsed.url);
+            if (isAlive) {
+                return parsed;
+            }
+            // Stale state file from killed/crashed session
+            try {
+                fs.unlinkSync(filePath);
+            }
+            catch { }
+        }
+        return null;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testspectra/cli",
-  "version": "1.1.11-rc.5",
+  "version": "1.1.12",
   "description": "TestSpectra Cross-Platform Test Runner CLI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -26,9 +26,9 @@
   ],
   "dependencies": {
     "@clack/prompts": "^1.7.0",
-    "@testspectra/matchers": "^1.1.11-rc.5",
-    "@testspectra/react": "^1.1.11-rc.5",
-    "@testspectra/skills": "^1.1.11-rc.5",
+    "@testspectra/matchers": "^1.1.12",
+    "@testspectra/react": "^1.1.12",
+    "@testspectra/skills": "^1.1.12",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "cross-spawn": "^7.0.6",
@@ -36,12 +36,13 @@
     "ora": "^8.0.1",
     "typescript": "^5.6.3",
     "yaml": "^2.7.0",
-    "zod": "^3.23.8"
+    "zod": "^3.23.8",
+    "@testspectra/reporter": "1.1.8-rc.29"
   },
   "optionalDependencies": {
-    "@testspectra/cli-darwin-arm64": "1.1.11-rc.5",
-    "@testspectra/cli-linux-x64": "1.1.11-rc.5",
-    "@testspectra/cli-win32-x64": "1.1.11-rc.5"
+    "@testspectra/cli-darwin-arm64": "1.1.12",
+    "@testspectra/cli-linux-x64": "1.1.12",
+    "@testspectra/cli-win32-x64": "1.1.12"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",

package/templates/default/fixtures/sampleDocument.pdf

@@ -0,0 +1,14 @@
+%PDF-1.4
+1 0 obj<</Type/Catalog/Pages 2 0 R>>endobj
+2 0 obj<</Type/Pages/Kids[3 0 R]/Count 1>>endobj
+3 0 obj<</Type/Page/MediaBox[0 0 612 792]/Parent 2 0 R/Resources<<>>>>endobj
+xref
+0 4
+0000000000 65535 f 
+0000000009 00000 n 
+0000000058 00000 n 
+0000000115 00000 n 
+trailer<</Size 4/Root 1 0 R>>
+startxref
+206
+%%EOF

package/templates/default/package.json

@@ -17,8 +17,8 @@
     "postinstall": "spectra sync-types"
   },
   "devDependencies": {
-    "@testspectra/cli": "^1.1.11-rc.5",
-    "@testspectra/matchers": "^1.1.11-rc.5",
+    "@testspectra/cli": "^1.1.12",
+    "@testspectra/matchers": "^1.1.12",
     "@types/node": "^20.14.0",
     "@wdio/cli": "^9.2.8",
     "@wdio/local-runner": "^9.2.8",

package/templates/default/page-objects/MatchersPage/common.ts

@@ -0,0 +1,41 @@
+class MatchersPage {
+  get visibleElement() { return Spectra.get("#demo-visible-el"); }
+  get hiddenElement() { return Spectra.get("#demo-hidden-el"); }
+  get existingElement() { return Spectra.get("#demo-existing-el"); }
+  get submitButton() { return Spectra.get("#demo-submit-btn"); }
+  get disabledButton() { return Spectra.get("#demo-disabled-btn"); }
+  get checkbox() { return Spectra.get("#demo-checkbox"); }
+  get radio() { return Spectra.get("#demo-radio"); }
+  get emailInput() { return Spectra.get("#demo-email-input"); }
+  get tokenInput() { return Spectra.get("#demo-token-input"); }
+  get exactText() { return Spectra.get("#demo-exact-text"); }
+  get partialText() { return Spectra.get("#demo-partial-text"); }
+  get activeTab() { return Spectra.get("#demo-active-tab"); }
+  get navLink() { return Spectra.get("#demo-nav-link"); }
+  get styledElement() { return Spectra.get("#demo-styled-el"); }
+  get focusInput() { return Spectra.get("#demo-focus-input"); }
+  get productCards() { return Spectra.getAll(".demo-product-card"); }
+  get emptyList() { return Spectra.getAll("#demo-empty-list > *"); }
+  get overviewSection() { return Spectra.get("#overview"); }
+  overviewSubtitle() { return this.overviewSection.get("#demo-page-subtitle"); }
+  overviewOutsideElement() { return this.overviewSection.get("#demo-submit-btn"); }
+
+  // API Interception & Mocking elements
+  get fetchApiButton() { return Spectra.get("#fetch-api-btn"); }
+  get fetchStatusBadge() { return Spectra.get("#fetch-status-badge"); }
+  get fetchedItems() { return Spectra.getAll(".api-fetched-item"); }
+  get fetchLoadingIndicator() { return Spectra.get("#fetch-loading-indicator"); }
+  get fetchCustomUrlInput() { return Spectra.get("#fetch-custom-url-input"); }
+  get postTitleInput() { return Spectra.get("#post-input-title"); }
+  get postBodyInput() { return Spectra.get("#post-input-body"); }
+  get submitPostButton() { return Spectra.get("#submit-post-btn"); }
+  get postStatusBadge() { return Spectra.get("#post-status-badge"); }
+  get postSuccessBanner() { return Spectra.get("#post-success-banner"); }
+  get postResponseJson() { return Spectra.get("#post-response-json"); }
+
+  async open(section = "") {
+    await Spectra.navigate("/" + (section ? "#" + section : ""));
+  }
+}
+
+export default new MatchersPage();

package/templates/default/page-objects/MatchersPage/mobile.ts

@@ -41,6 +41,12 @@ class MatchersPage {
 
   async open(section = "") {
     try {
+      // If a previous test or deep link left the app on a sub-screen, return to home first
+      const hasBackBtn = await Spectra.get("~back-to-home-btn").isDisplayed().catch(() => false);
+      if (hasBackBtn) {
+        await Spectra.get("~back-to-home-btn").click();
+      }
+
       // A fresh app process (relaunched by the orchestrator's bootstrap before every suite) has to
       // fetch, parse, and execute the RN JS bundle from Metro before anything is on screen — on a
       // cold start this can take well past a normal action's poll budget. Wait for the home screen
@@ -48,6 +54,7 @@ class MatchersPage {
       // real failure to surface confusingly on whatever element the test touches next.
       await Spectra.get("~toggle-sidebar-btn").waitForElement(30000);
 
+      const target = section || "overview";
       const isDrawerOpen = await Spectra.get("~close-sidebar-btn").isDisplayed().catch(() => false);
       if (!isDrawerOpen) {
         await Spectra.get("~toggle-sidebar-btn").click();
@@ -60,9 +67,7 @@ class MatchersPage {
         // the Modal is slow to materialize.
         await Spectra.get("~close-sidebar-btn").waitForElement(10000);
       }
-      if (section) {
-        await Spectra.get(`~nav-item-${section}`).click();
-      }
+      await Spectra.get(`~nav-item-${target}`).click();
     } catch {}
   }
 }

package/templates/default/page-objects/PlaygroundPage/mobile.ts

@@ -20,6 +20,12 @@ class PlaygroundPage {
 
   async open() {
     try {
+      // If a previous test or deep link left the app on a sub-screen, return to home first
+      const hasBackBtn = await Spectra.get("~back-to-home-btn").isDisplayed().catch(() => false);
+      if (hasBackBtn) {
+        await Spectra.get("~back-to-home-btn").click();
+      }
+
       // See MatchersPage.open()'s equivalent comment: waits for the cold-start home screen, then
       // for the drawer Modal to actually finish materializing before clicking a nav item inside
       // it — both races that otherwise surface as an occasional ~10s stall on the next click.

package/templates/default/page-objects/PlaygroundPage/web.ts

@@ -17,6 +17,8 @@ class PlaygroundPage {
   get focusInput() { return Spectra.get("#demo-focus-input-pg"); }
   get productItems() { return Spectra.getAll(".demo-product-item"); }
   get emptyList() { return Spectra.getAll("#demo-empty-list-pg > *"); }
+  get fileInput() { return Spectra.get("#demo-file-input-pg"); }
+  get uploadedFilename() { return Spectra.get("#demo-uploaded-filename"); }
 
   async open() {
     await Spectra.navigate("/#playground");

package/templates/default/specs/Authentication/TC-0021-seed-authenticated-session/mobile.test.ts

@@ -4,4 +4,7 @@ it("Seed an authenticated session via Spectra.seedSession() instead of the real
   await Spectra.seedSession();
 
   await AuthPage.statusBadge.shouldHaveText("Authenticated as demo@testspectra.dev");
+
+  // Return to the home screen so later suites in the same batch don't inherit this route.
+  await Spectra.get("~back-to-home-btn").click();
 });

package/templates/default/specs/BrowserContext/TC-0007-title-and-navigation/mobile.test.ts

@@ -1,6 +1,9 @@
 it("Verify page title and sidebar navigation links", async () => {
   await MatchersPage.open();
 
+  // Open sidebar drawer to view navigation links
+  await NavigationPage.toggleSidebarButton.click();
+
   // Navigation sidebar collection verification
   await NavigationPage.sidebarLinks.shouldHaveLengthGreaterThan(0);
 

package/templates/default/specs/BrowserContext/TC-0007-title-and-navigation/web.test.ts

@@ -8,7 +8,7 @@ it("Verify page title and sidebar navigation links", async () => {
   // Browser URL assertions
   const currentUrl = await browser.getUrl();
   await Spectra.browser.shouldHaveUrl(currentUrl);
-  await Spectra.browser.shouldContainUrl("localhost:5173");
+  await Spectra.browser.shouldContainUrl("localhost");
 
   // Page lifecycle and console error diagnostics
   await Spectra.browser.shouldBeLoaded();

package/templates/default/specs/Playground/TC-0003-file-upload/web.test.ts

@@ -0,0 +1,11 @@
+it("Verify uploading image and document fixtures to file input", async () => {
+  await PlaygroundPage.open();
+
+  // 1. Upload sample image fixture
+  await PlaygroundPage.fileInput.upload(Fixture.sampleImage);
+  await PlaygroundPage.uploadedFilename.shouldContainText("sampleImage");
+
+  // 2. Upload sample PDF document fixture
+  await PlaygroundPage.fileInput.upload(Fixture.sampleDocument);
+  await PlaygroundPage.uploadedFilename.shouldContainText("sampleDocument");
+});

package/templates/default/spectra.config.ts

@@ -2,11 +2,13 @@ import { defineConfig } from "@testspectra/cli";
 
 export default defineConfig({
   webConfig: {
-    baseUrl: "http://localhost:5173",
+    baseUrl: "http://localhost:5180",
     maxConcurrentSessions: "1",
     headless: true,
     implicitWait: "5000",
     parallelizationMode: "testcase",
+    // Failure-only video recording (default: true)
+    video: true,
   },
   androidConfig: {
     driverServer: "tcp://127.0.0.1:8200",
@@ -15,6 +17,8 @@ export default defineConfig({
     noReset: false,
     implicitWait: "10000",
     parallelizationMode: "suite",
+    // Failure-only video recording (default: true)
+    video: true,
     devices: [
       {
         id: "emulator-5554",