docs(help): what size of map works best (#1253) #1254

Merged

claude-bot merged 1 commit from docs/map-size-guide into main 2026-10-28 05:05:53 +00:00

Conversation 0 Commits 1 Files changed 2 +45

claude-bot commented 2026-10-28 00:27:50 +00:00

Collaborator

Copy link

Closes #1253.

Adds "Maps, and the best size for one" to the GM guide (/help/gm), as a ### under "6. Prep". The guide keeps its ten numbered sections, so "On this page" and the pinned section count in HelpPage.test.jsx are unchanged.

What it says, and where each number comes from:

• Landscape 3:2 or 16:9, because the frame takes the map's shape but is capped at min(70vh, 560px) (60vh on a phone), per Map.css.
• 3,000–4,000 px on the long side, up to about 6000 × 4000 for detail. A map opens fit-to-frame and only zoom 0 is cut (map_tiles.py), so every tile loads at once.
• JPEG with a solid background: tiles are convert("RGB") JPEG at q85. Sides in multiples of 256 avoid edge padding.
• Limits: 75 MB (map_max_upload_bytes, configurable), 16,384 px longest side (MAX_SIDE_PIXELS), 8192 × 6144 for JPEG/PNG (MAP_MAX_PIXELS), and about 12.5 MP for WebP (_WEBP_WEIGHT = 4, which still applies to maps).

HelpPage.test.jsx passes (20 tests). Changelog fragment changelog.d/1253-map-size-guide.added.md.

🤖 Generated with Claude Code

Closes #1253. Adds **"Maps, and the best size for one"** to the GM guide (`/help/gm`), as a `###` under "6. Prep". The guide keeps its ten numbered sections, so "On this page" and the pinned section count in `HelpPage.test.jsx` are unchanged. What it says, and where each number comes from: - Landscape 3:2 or 16:9, because the frame takes the map's shape but is capped at `min(70vh, 560px)` (60vh on a phone), per `Map.css`. - 3,000–4,000 px on the long side, up to about 6000 × 4000 for detail. A map opens fit-to-frame and only zoom 0 is cut (`map_tiles.py`), so every tile loads at once. - JPEG with a solid background: tiles are `convert("RGB")` JPEG at q85. Sides in multiples of 256 avoid edge padding. - Limits: 75 MB (`map_max_upload_bytes`, configurable), 16,384 px longest side (`MAX_SIDE_PIXELS`), 8192 × 6144 for JPEG/PNG (`MAP_MAX_PIXELS`), and about 12.5 MP for WebP (`_WEBP_WEIGHT = 4`, which still applies to maps). `HelpPage.test.jsx` passes (20 tests). Changelog fragment `changelog.d/1253-map-size-guide.added.md`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

claude-bot added 1 commit 2026-10-28 00:27:50 +00:00

docs(help): what size of map works best (#1253) ... 6053aedd42

A sub-section of "6. Prep" in the GM guide: where maps live, the shape
and size that suit the map frame, why a very large map is slow to open
(only zoom 0 is cut, and a map opens showing every tile), and the
limits on a map's picture, including WebP's quarter-size one.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

claude-bot scheduled this pull request to auto merge when all checks succeed 2026-10-28 04:19:49 +00:00

rbrooks force-pushed docs/map-size-guide from 6053aedd42 to 65ed84a154 2026-10-28 04:19:50 +00:00 Compare

claude-bot merged commit b77d87a686 into main 2026-10-28 05:05:53 +00:00

claude-bot referenced this pull request from a commit 2026-10-28 05:05:55 +00:00

docs(help): what size of map works best (#1253) (#1254)

claude-bot deleted branch docs/map-size-guide 2026-10-28 05:05:55 +00:00

claude-bot referenced this pull request 2026-10-28 05:06:25 +00:00

Help: say what size of map works best #1253

Sign in to join this conversation.

Reviewers

No reviewers

Labels

Clear labels   

backend

Issue related to the backend

  

bot

Issue related to the bot

  

bug

Something is not working

  

duplicate

This issue or pull request already exists

  

enhancement

New feature

  

frontend

Issue related to the frontend

  

help wanted

Need some help

  

invalid

Something is wrong

  

question

More information is needed

  

recording

Issue related to the recording system

  

security

Security hardening / vulnerability work

  

wontfix

This won't be fixed

No labels

backend

bot

bug

duplicate

enhancement

frontend

help wanted

invalid

question

recording

security

wontfix

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

2 participants

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

rbrooks/Quest-Board!1254

No description provided.