Skip to content
Back to search

create-photo-flipbook-ui

Codex skill for building responsive 3D photo flipbook websites from user-supplied images

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/haichaolihc--create-photo-flipbook-ui/badge.svg)](/listings/haichaolihc--create-photo-flipbook-ui)

HTML

<a href="/listings/haichaolihc--create-photo-flipbook-ui"><img src="/api/listings/haichaolihc--create-photo-flipbook-ui/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --repo HaichaoLihc/create-photo-flipbook-ui \
  --path skills/create-photo-flipbook-ui \
  --ref main

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 98 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # [找作者定制 →](https://makehologram.com/)
  2. Explore the platform for discovering and using new visual experiences.
  3. # Create Photo Flipbook UI
  4. **English** · [简体中文](README.zh-CN.md)
  5. ## [Visit the website →](https://haichaolihc.github.io/create-photo-flipbook-ui/)
  6. Create a photo flipbook from your photos with a Codex skill that curates images, designs expressive photobook spreads, and builds an interactive page-turning website. The skill uses the bundled **3D hardcover book** runtime in [`assets/3d-book/`](skills/create-photo-flipbook-ui/assets/3d-book/).
  7. The website supports English and Simplified Chinese. On the main URL, it uses your browser’s preferred supported language; the language switch remembers your choice. This README has a separate [Chinese translation](README.zh-CN.md).
  8. The project website and GitHub Pages build live in [`website/`](website/). Reusable UI templates live separately in [`ui-collections/`](ui-collections/).
  9. ## UI collections
  10. These templates live in `ui-collections/`, outside the skill folder, and are optional resources for people to copy and customize. They are not installed with the skill. The skill uses its own bundled 3D hardcover runtime; the library, 3D readers, film archive, spatial galleries, and photo stream are separate alternatives.
  11. | [Library](ui-collections/library/) | [2D Book](ui-collections/2d-book/) |
  12. | --- | --- |
  13. | ![Library with three mock books](docs/images/library.png) | ![2D Book with a sample photo spread](docs/images/death-valley-flipbook.jpg) |
  14. | Reorderable shelf with three empty mock books. | Standalone 2D template; not included in the skill. |
  15. | [3D Book 1](ui-collections/3d-book-1/) | [3D Book 2](ui-collections/3d-book-2/) |
  16. | --- | --- |
  17. | ![3D Book 1 on a dark background](docs/images/3d-book-1.png) | ![3D Book 2 on a light background](docs/images/3d-book-2.png) |
  18. | React and WebGL reader with curved pages and a dark stage. | Three.js and Quick FlipBook reader with a light stage and soft shadows. |
  19. | [Card Gallery](ui-collections/card-gallery/) | [Image Atlas](ui-collections/image-atlas/) | [Photo Ring](ui-collections/photo-ring/) |
  20. | --- | --- | --- |
  21. | ![Card Gallery with numbered placeholder cards](docs/images/card-gallery.png) | ![Image Atlas with concentric year-based image rings](docs/images/image-atlas.png) | ![Photo Ring with layered placeholder images](docs/images/photo-ring.png) |
  22. | Scroll or drag cards through a ring, an arc, a stack, and an unfolded strip. | Explore a spatial archive of concentric year rings, with theme search and focused image browsing. | Switch between Flat, Tilt, Ring, and Gallery layouts while preserving your browsing position. |
  23. These three galleries use vanilla HTML, CSS, and JavaScript with local SVG
  24. placeholders and fictional sample content—no personal photographs or external
  25. image requests. No install or build step is needed; see each linked README for
  26. preview instructions and how to add your own images.
  27. ### [Stream / Undertow](ui-collections/stream-implement-3d/)
  28. ![Stream: a waterfall of glowing photo threads](docs/images/stream.png)
  29. A waterfall of light, with a photo story flowing through every thread. Bring your own photos. [Setup →](ui-collections/stream-implement-3d/README.md)
  30. ## Install
  31. ```bash
  32. python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  33. --repo HaichaoLihc/create-photo-flipbook-ui \
  34. --path skills/create-photo-flipbook-ui \
  35. --ref main
  36. ```
  37. ## Use
  38. ```text
  39. Use $create-photo-flipbook-ui to turn these photographs into photobooks.
  40. ```
  41. One workflow, four stages:
  42. 1. **Understand the photos:** their form, content, themes, and unexpected relationships. Semantic search and contact sheets are available.
  43. 2. **Explore creative directions:** develop distinct concepts for the theme, image presentation, motifs, material, typography, cover, and page turns; choose the strongest direction for the collection.
  44. 3. **Design and generate the spreads:** carry the selected concept through the sequence. Generate every complete spread with ImageGen using the selected photos as references, including the outside cover and all interior spreads.
  45. 4. **Build the UI:** split the generated artwork into facing leaves, present it with the built-in 3D hardcover runtime, and deliver a working local URL.
  46. The agent chooses the art direction and sequence. ImageGen is required for every spread unless the user explicitly overrides that production method.
  47. [Creative ideation](skills/create-photo-flipbook-ui/references/creative-ideation.md) explores possibilities before layouts are fixed. The [default editorial zine principles](skills/create-photo-flipbook-ui/references/default-style.md) combine recognizable photography, selective artistic transformation, purposeful page composition, and consistent typography. A small artistic vocabulary drawn from the photos develops across the book: some passages rest, others mix photography with cutouts, overprinting, drawing, or abstraction, and selected moments can transform more boldly. Ordinary middle pages should express this language too. Neither untouched photo boxes throughout nor continuous paintings on every turn establish the intended balance. Pale paper and a standard cover are not prescribed. [Book rhythm](skills/create-photo-flipbook-ui/references/book-rhythm.md) guides changes across page turns. Each run reviews the cover, quiet, impact, and representative middle pilots, then checks the complete book for artistic quality, continuity, and repetition. The reader displays complete generated artwork and ships without sample photographs. Creative directions, sequence plans, prompts, source associations, generated masters, and rhythm reviews remain with each output.
  48. ## Photo search and reusable code
  49. The skill declares the existing `photo-search` MCP dependency for library search, ranked contact sheets, and larger previews. The MCP itself is read-only. The bundled `scripts/photo_library.py` adapter adds folder-specific cached indexes and semantic searches by reusing an installed photo-search engine's `index.py` and `PhotoSearchEngine`; it does not replace the connected MCP's global index.
  50. Install the engine and its Python requirements separately, set `PHOTO_SEARCH_ENGINE_DIR` to its location, and use its Python interpreter. See [Photo library setup and commands](skills/create-photo-flipbook-ui/references/photo-library.md). Index caches remain outside the skill and source folders. New and changed images are embedded incrementally; unchanged images are reused. Search output includes a contact sheet and manifest, and selections retain stable IDs and original paths.
  51. Reusable resources shipped with the skill include the photo-library adapter, ordered contact-sheet renderer and 3D hardcover book runtime. Art direction and sequencing remain in workflow instructions. Model weights and photo libraries are not part of the skill package.
  52. See each template’s README for local preview instructions.
  53. [Negative Sleeves](ui-collections/film-negative-flipbook/) is a separate, photo-free film archive
  54. UI with page-corner previews, draggable film strips, reversible single-frame
  55. inspection, and optional continuously paginated semantic search. Import a local
  56. photo folder with its Python builder; generated books and photographs stay Git-ignored.
  57. ## Validate
  58. ```bash
  59. python3 tests/validate_repo.py
  60. ```
  61. [Evaluation guide](evals/README.md).
  62. ## License
  63. Original project code and the installable skill are [MIT licensed](LICENSE). Third-party components retain their own licenses. The adapted code in `ui-collections/3d-book-1/` and all photographs, videos, and other media are excluded unless expressly stated otherwise.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.