Test on macOS and Linux and report what you find
Nobody has claimed this yet.
Assessment
- Difficulty
- 1/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 62/100
- Issue type
- Documentation
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- javascript, linux, macos, nodejs, threejs
- Domain
- documentation, testing-qa
Research direction
Start with docs/PopBook-Beginners-Guide.pdf and follow it step by step on macOS or Linux: install dependencies, run POPBOOK_MOCK=1 npm start (no AI key needed), drop a sample PDF, build, open the book and export the HTML. Note every command that fails, screenshot that differs, or WebGL problem, then post the findings with OS, Node version and browser. Done means a written report of mismatches posted in Discussions or on this issue.
Written by the indexing model from the issue text.
Description
What problem would this solve?
CI runs the unit tests on Linux and Windows, but nobody has done a full walkthrough on macOS or on a Linux desktop yet: install, npm start, drop a PDF, build, open the book, export the HTML.
What would you like to happen?
Follow the beginner's guide (docs/PopBook-Beginners-Guide.pdf) on your machine and tell us where it didn't match reality: commands that failed, screenshots that look different, WebGL problems, anything confusing. Post the result in Discussions (Q&A) or comment here with your OS, Node version and browser. A short POPBOOK_MOCK=1 npm start run is enough, no AI key needed.
Alternatives you've considered
No response
Contribution
- I'd like to work on this myself
- Dominant language
- JavaScript
- Stars
- 8
- Forks
- 1
- Avg merge
- 17m
- Merged PRs (30d)
- 1
Getting set up
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from AlphaaCode/Popbook
-
enhancement good first issue help wanted
Difficulty 2/5 Half a day Newbie friendliness 66/100
AlphaaCode/Popbook#10 · 1 comment ·
-
documentation good first issue help wanted
Difficulty 1/5 1-3 hours Newbie friendliness 62/100
AlphaaCode/Popbook#7 ·
-
enhancement help wanted scene block
Difficulty 3/5 1-2 days Newbie friendliness 58/100
AlphaaCode/Popbook#9 ·
All issues in AlphaaCode/Popbook
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 66/100
riverqueue/river#1576 ·
Maintainers usually reply within 1 day
-
documentation good first issue
Difficulty 1/5 Under an hour Newbie friendliness 72/100
Maintainers usually reply within 1 day
-
good first issue help wanted
Difficulty 1/5 Under an hour Newbie friendliness 88/100
modrollstudio/Modroll-Studio-Website#80 · 1 comment ·
Maintainers usually reply within 1 day
-
good first issue help wanted
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
mafzalkalwardev/mailforge#21 ·
-
good first issue help wanted
Difficulty 1/5 Under an hour Newbie friendliness 82/100