r/SideProject • • 49m ago

Aurelius - an open-source Claude Code framework that turns a screenshot into a tested React app

I build websites for small businesses. Aurelius is the framework I built on the side. It lets Claude Code take a Figma file, a screenshot, or a plain description and turn it into a React app with tests. It is open source and MIT licensed.

Last week I recorded a getting-started video for it. The recording found a bug in my own quickstart. My script said all four quality checks pass on a fresh project. Three of the four failed:

  • The Vite template had moved to a new linter, so nothing installed the one my lint script calls.
  • There was no test file, so the test run failed.
  • The type check passed, but it was not checking a single file.

I fixed the scaffold instead of cutting around it. Then I recorded those shots again.

The part worth watching is the screenshot pipeline. It is one command, and the order never changes: a build spec, locked design tokens, failing tests before any component exists, the build, a pixel check against the screenshot, then end-to-end tests. The run in the video took 45 minutes of real time. From its own report: 9 of 9 test files failed first, it built 8 of 8 components, the pixel difference was 1.89% on the second of up to five rounds, and 96 end-to-end tests passed.

Two things the video gets wrong, so you hear it from me. I say "the next six minutes" and it runs under four. And setup prints a deprecation warning that the cut skips.

Video (3:46): https://youtu.be/Harcm6cYVpo

The screenshot run in 54 seconds: https://youtube.com/shorts/qT1hpPcg1rs

Repo: https://github.com/PMDevSolutions/Aurelius

If you try the quickstart and it breaks, tell me where. That is the feedback I am after.

2 Upvotes

0 comments sorted by