Thanks for wanting to help. Toran is small on purpose, so the bar for a change is that it keeps the first swipe instant and the page light.
The easiest contribution needs no code. Open the Add a door form and write one line about a door you remember. Once it is approved, a pull request adds it to doors.json and it hangs on a leaf.
If something about a toran, a word or a region is wrong, use Suggest a fix. A source helps.
-
Fork the repo and create a branch.
-
Run the site locally with
python3 -m http.server 8391and open http://127.0.0.1:8391. -
Run the tests.
npm ci npm test npx playwright install chromium npm run test:browser -
Open a pull request that says what changed and why. For anything you can see or hear, add a screenshot or a short clip from the running page.
Please keep these constraints.
- No runtime dependencies, build step, CDN scripts, web fonts, trackers or analytics. Test tooling as a dev dependency is fine.
- Sound stays off until the visitor turns it on, and reduced motion is respected.
- It has to work on a phone with touch as well as with a mouse.
- A new toran style needs an accurate description of where and how that toran is used.
- Visitor text is only ever rendered with
textContent.