Skip to content

docs: highlight routing and previews with a new app icon - #3

Merged
MoraesGil merged 2 commits into
mainfrom
codex/app-icon-readme
Nov 11, 2026
Merged

MoraesGil merged 2 commits into
mainfrom
codex/app-icon-readme

Conversation

@MoraesGil

@MoraesGil MoraesGil commented Nov 10, 2026 •

Copy link
Copy Markdown
Owner

What changes

Both READMEs now lead with the app's two main workflows: open a 3MF in the right slicer, and preview its build plate before opening it. The existing preview gallery follows the animated routing demo, with separate captions for painted colours and multi-plate projects.

Adds an original macOS app icon, displayed in the README and bundled by both the Xcode and native build paths. The PNG master and multi-resolution ICNS are included.

Why

Finder thumbnails and Quick Look are a primary feature, but their demos were below several routing sections. Visitors should see both main capabilities before the configuration details.

How it was checked

  • Xcode Release build completed; deep, strict code-signature verification passed.
  • Native Release build completed; deep, strict code-signature verification passed.
  • Both bundles contain the expected CFBundleIconFile and byte-identical AppIcon.icns; ICNS structure and size representations validated.
  • Local image paths, document links, section anchors and demo order checked in both languages; git diff --check passed.
  • Gitleaks scan of the publication diff returned no findings.
  • Installed the tested build in /Applications on the existing test Mac; 39 local tests passed with zero failures. Verified the 3MF default handler, macOS-resolved app icon, enabled Quick Look extensions, configured routing decisions and a 512px thumbnail returned by the macOS thumbnail service.

Notes for the reviewer

Before After
Routing leads the introduction; preview examples appear after routing rules and open-project handling. Routing demo is immediately followed by the preview gallery. Finder thumbnails and Quick Look have distinct explanations.
No dedicated app icon. Layered model, build plate and routing arrow used for the app icon and README identity.

The existing synthetic preview images are reused unchanged. No new screenshots or recordings were captured. Review the rendered English and Portuguese READMEs and the icon assets directly.

This change affects documentation and app-icon packaging. It does not modify routing, thumbnail rendering, signing requirements or permissions. The app was rebuilt and installed as an upgrade on the existing test Mac. A clean first-install permission flow and an interactive Finder/Quick Look walkthrough were not tested in this pass. The Xcode build process stalled locally; the supported native build completed the local tests and installation. PR CI passed with Xcode.

Known background limitation confirmed after installation: the registered indexer returned 78: EX_CONFIG when started and did not write a new worker log entry. On-demand thumbnail generation passed independently. Background startup remains experimental in ad-hoc builds, as documented in both READMEs; this PR does not resolve that existing issue.

@MoraesGil MoraesGil added the documentation Improvements or additions to documentation label Nov 10, 2026
@MoraesGil
MoraesGil merged commit 00ed5bd into main Nov 11, 2026
1 check passed
@MoraesGil
MoraesGil deleted the codex/app-icon-readme branch November 11, 2026 00:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant