run-reg-webapp

Orchestrates FastAPI and Svelte servers and captures Playwright screenshots of registry metadata catalog interfaces.

2|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/adamaltmejd/registry-research-toolkit --skill run-reg-webapp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-reg-webapp
Source: https://github.com/adamaltmejd/registry-research-toolkit/tree/main/reg_webapp/.claude/skills/run-reg-webapp
Command: npx skills add https://github.com/adamaltmejd/registry-research-toolkit --skill run-reg-webapp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires uv, bun, playwright, uvicorn, and includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the development lifecycle of the reg_webapp by automating the orchestration of FastAPI and Svelte servers, ensuring consistent local environments and visual verification.

Core Features & Use Cases

  • Automated Orchestration: Starts and tears down backend and frontend servers with automatic port management to prevent collisions.
  • Visual Verification: Runs a Playwright-based driver to smoke-test catalog navigation and capture responsive screenshots across multiple breakpoints.
  • Use Case: Use this to verify that a new metadata schema change correctly renders in the web interface without manually configuring ports or managing background processes.

Quick Start

Execute the run-reg-webapp skill to start the development servers and perform a full smoke test of the catalog browsing flow.

Frequently Asked Questions about run-reg-webapp

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

FAQPage Schema
How do I automate local testing for a FastAPI and Svelte webapp?

Automate FastAPI and Svelte webapp testing by orchestrating local server execution with a Playwright driver, which handles startup, teardown, and automated smoke testing of catalog navigation flows. This approach ensures consistent local environments without manual port configuration.

How can I capture responsive screenshots across multiple breakpoints during webapp development?

Capture responsive screenshots during webapp development by running a Playwright-based visual verification driver that interacts with the headless browser and generates screenshots across multiple configured breakpoints for the registry metadata catalog interfaces.

Do I need to install Bun and uvicorn to run automated visual tests?

Yes, you need to install Bun and uvicorn, along with uv and Playwright, because the automated visual testing requires a configured Python and Bun environment to orchestrate the FastAPI backend and Svelte frontend servers.

How do I prevent port collisions when running local backend and frontend servers?

Prevent port collisions when running local backend and frontend servers by using automated orchestration that manages startup and teardown with automatic port management, ensuring the FastAPI and Svelte servers do not conflict during local execution.

What is the best way to verify that a metadata schema change renders correctly in a web interface?

Verify metadata schema changes render correctly by executing an automated smoke test that orchestrates the local FastAPI and Svelte servers, navigates the catalog browsing flow, and captures visual screenshots to confirm the interface renders the updated metadata accurately.

When should I not use automated orchestration for local webapp testing?

You should not use automated orchestration for local webapp testing if your environment lacks the required uv, Bun, Playwright, and uvicorn dependencies, or if your testing needs do not involve visual verification of FastAPI and Svelte catalog interfaces.