0 Fork 0

mirror of https://github.com/PR0M3TH3AN/Artstr-Studio.git synced 2026-11-07 14:10:08 +00:00

Files

T

thePR0M3TH3ANandClaude Opus 4.7 23a16c8e89 docs: in-app "Read the docs" modal + per-mode help pages

Adds a 📖 Docs link to the sidebar footer (next to GitHub + artstr.org)
that opens a Read-the-Docs-style two-pane modal: topic sidebar on the
left, rendered markdown on the right.

Content (src/help/*.md, 11 files):
- index.md            — overview + nav
- template.md         — Template tab explainer
- designer.md         — Designer tab explainer
- cover.md            — Case cover wrap
- disc.md             — Disc-label sheet
- jewel.md            — Jewel-case insert
- customart.md        — Custom art
- slide.md            — Slide
- deck.md             — Slide deck
- pixelart.md         — Pixel art
- book.md             — Book Designer (links out to the deeper
                        BOOK_DESIGNER_TUTORIAL.md + spec on GitHub)

Implementation:
- _DOCS_TOPICS registry maps slug → { title, group, file }. Sidebar
  groups headings under "Start here", "App tabs", "Template-mode
  layouts".
- loadDocsTopic(slug) fetches `help/<slug>.md` (force-cache), renders
  via the already-vendored marked, caches the rendered HTML for
  session-instant re-visits, and updates the URL hash via
  history.replaceState so deep links work.
- #/help/<slug> hash route auto-opens the modal at that topic on
  page load + on hashchange.
- Esc closes; backdrop click closes; internal `#/help/foo` links in
  page content load via the dispatcher (no page bounce); external
  http(s) links get target="_blank" + noopener.

Styling:
- Inherits the rest of the modal aesthetic (var(--line),
  var(--accent), system font for chrome, Georgia serif for body
  text). Dark-mode-aware backdrops on code / blockquote / table
  blocks.
- Two-pane layout collapses to a narrower sidebar on <720px viewports.

Files live in src/help/ (not docs/) because Vercel's outputDirectory
is "src" — the production site only serves files under src/. The
canonical deeper docs (BOOK_DESIGNER_TUTORIAL, FEATURE specs) stay
in docs/ and are linked-out from the in-app pages.

Co-Authored-By: Claude Opus 4.7 <[email protected]>

2026-06-04 08:52:34 -04:00

1.6 KiB

Raw Blame History

Case cover wrap

A printable wraparound for DVD, Blu-ray, softcover, or any back + spine + front case format.

Geometry

Trim — outer cut line.
Bleed — extends past the trim on each outer edge so the printer's cut tolerance doesn't reveal white.
Spine — middle strip whose width depends on the case style (DVD = 14 mm, Blu-ray = 11 mm, etc).
Safe area — interior margin you should keep text + key art inside.

Pick a preset in the sidebar (DVD / Blu-ray / U-Card / Custom) or enter your own panel width + trim height + spine + bleed under the Custom preset.

Artwork modes

Combined wraparound — one canvas spanning the full back+spine+front. Best for continuous artwork.
Slots — separate back / spine / front layers. Best for posters
- spine text + back-cover layout.

Slots panel

When you're in slot mode, each panel exposes:

A drop-zone for an image or a published cover design from Nostr.
Fit (cover / contain / fill / none), zoom, position offsets, rotation.
Show / hide for testing different layouts.

Spine text

The Spine label input adds a vertical text caption along the spine. Family + weight + colour controls in the right options pane.

Common gotchas

The show guides checkbox toggles trim + bleed lines on the canvas; show crops adds the cut marks. Both stay off in the exported file unless you also enable the matching print options.
Switching presets resets panel widths to that preset's defaults — if you've customised, save first.
Publishing posts a casewrap-cover event with the same flat payload anyone can fork.

1.6 KiB Raw Blame History