skills.rest
iv-zhang
iv-zhangCOMMUNITY
Explore all skills by this author →
GitHub

run-bmrc-logistics

Boots the BMRC Logistics Next.js app against Firebase emulators and drives it with Playwright for screenshots and smoke tests.

2|Updated Dec 24, 2025
Search Tags:#screenshots#next.js#playwright#e2e testing#firestore#smoke test#firebase emulator
One-click install
npx skills add https://github.com/iv-zhang/BMRC-Logistics --skill run-bmrc-logistics-iv-zhang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: run-bmrc-logistics
Source: https://github.com/iv-zhang/BMRC-Logistics/tree/main/.claude/skills/run-bmrc-logistics
Command: npx skills add https://github.com/iv-zhang/BMRC-Logistics --skill run-bmrc-logistics-iv-zhang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @playwright/test, firebase-tools.

What problem does it solve? Verifying UI changes in the BMRC Logistics app normally requires a running Firebase backend and manual clicking through pages. This Skill boots the Next.js app against seeded Firestore and Auth emulators and drives it with Playwright, so you can confirm pages render and capture screenshots without ever touching production data. ## Core Features & Use Cases - Emulator-backed smoke driver: One command starts the Firestore and Auth emulators, seeds representative data plus an admin user, boots next dev, and runs the Playwright spec. - Screenshot capture: Writes PNG screenshots of statpacks, buy-list, assets, inventory, dashboard, and other surfaces to the skill's screenshots/ folder for visual review. - Auth-gated page testing: Signs in through the real /login form against the Auth emulator so admin-gated pages (dashboard, inventory, audit, assets) render for verification. - Use Case: Before committing a UI change, ask the agent to run the smoke driver and inspect the generated screenshots to confirm the pages render correctly against seeded data. ## Quick Start Ask the agent to run the BMRC Logistics smoke driver and show you the screenshots of the main pages.

Frequently Asked Questions about run-bmrc-logistics

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run the BMRC Logistics app locally with test data?▼

Run the smoke driver with firebase emulators:exec --only firestore,auth --project demo-bmrc-logistics wrapping the Playwright test command. It seeds the emulators, boots next dev against them, and drives the main pages automatically.

How do I test Firebase auth-gated pages with the emulator?▼

Include the Auth emulator via --only firestore,auth so global-setup seeds an admin account (smoke-admin@example.com / test1234). The signIn(page) helper then logs in through the real /login form, satisfying onAuthStateChanged gates on dashboard, inventory, audit, and assets.

Does the smoke driver touch production Firebase data?▼

No. The driver uses the demo-bmrc-logistics project id, which only resolves to local emulators, and boots a fresh dev server with emulator environment variables. Production is only reachable via the separate human path of npm run dev with real credentials.

Why does Playwright networkidle never fire with Firestore?▼

Firestore keeps long-lived listener sockets open via onSnapshot, so the network never goes idle. The driver instead waits on the load event plus a fixed 2500ms timeout before screenshotting pages.

When should I run the smoke driver versus type checking?▼

Run the driver only before a commit or when screenshots are explicitly requested, since it is expensive in time and tokens. For everyday verification use npx tsc --noEmit, npm run lint, npm run build, and npm run test.

Related Skills

Explore More Software Engineering Skills→
pxlcrtivpxlcrtiv

firebase-basics

Set up and manage Firebase projects with the Firebase CLI.

Community
Intermediate
spencerpaulyspencerpauly
672

visual-qa-testing

Verify web application UI behavior and visual output in Cursor's built-in browser.

Community
Intermediate
ivegamsftivegamsft

test-and-rebuild

Run unit tests, TypeScript checks, Docker rebuilds, and smoke tests.

Community
Advanced
Kiln-AIKiln-AI
5.0k

playwright

Drive Kiln's web UI in a real browser and run its Playwright end-to-end test suite.

Official
Advanced