Agentic Flow for a Simple SPA Anyone Can Build

Description and use

Rapid SPA prototyping without a build step: template, local Python server, Playwright tests, and GitHub Pages. Screenshots speed code review, and an agent generates changes that are automatically tested.

Problem

Developing and iterating on simple SPAs quickly while delegating code changes to an agent, without a complex build or bundler setup.

Outcome

The workflow enables a developer to prototype, test, and deploy a SPA in minutes, while an agent can generate code changes that are automatically reviewed via visual screenshots, reducing review time and speeding UI iteration.

Workflow

• Create repo from kolodkin/spa-template via "Use this template" or agent command
• Edit code in web/ folder
• Run ./run.sh to start local server (Python http.server)
• Run uv run pytest to execute Playwright tests and capture screenshots
• Push to main to trigger CI: test, build (cp to _site), deploy to GitHub Pages
• Review screenshots in test-results/shots/ to approve or request changes
• Merge PR or iterate

Evidence

Getting your own is a two-minute job. kolodkin/spa-template is a GitHub template, so hit Use this template

Source

Pull requests run the first two jobs as a check. Pushes to main run all three.

Source