Imported from guitarbeat/Zineify (
AGENTS.md). Install upstream withnpx skills add guitarbeat/Zineify. Copyright stays with the author.
Zine-ify
A client-side PWA that converts PDFs into printable 8-page mini zine layouts. No backend services or databases.
Agent configs
All agent workflows, learnings, and reference docs: agents/README.md
Cursor Cloud specific instructions
Services
| Service | Command | Port |
|---|---|---|
| Dev server | pnpm dev |
5000 |
Key commands
See package.json scripts for the full list. Highlights:
- Lint:
pnpm lint - Build:
pnpm build - Dev server:
pnpm dev(Vite, port 5000, host 0.0.0.0) - Tests:
pnpm test(Playwright — builds first, serves on port 8001)
Gotchas
- The Playwright
webServercommand inplaywright.config.jscallspython -m http.server. On environments where onlypython3is available, ensure apythonsymlink exists:sudo ln -sf /usr/bin/python3 /usr/local/bin/python. - Playwright tests require Chromium: run
pnpm exec playwright install --with-deps chromiumif browsers are not yet installed. - Some e2e tests (3D preview, mobile layout, mixed uploads, multi-file queue) have pre-existing failures unrelated to environment setup.
- The test PDF generator script is at
scripts/create_test_pdf.js— run withnode scripts/create_test_pdf.jsto create a sample 16-page PDF for manual testing.
