CinePortal

APP NAME
CinePortal

APP IDEA
Build an unofficial, polished, mobile-first Marvel movie-night decision app for one person choosing on behalf of a couple or friend group. It uses factual metadata for exactly 25 released Marvel Studios films, while every visual is newly generated original cinematic artwork rather than an official poster, still or actor image. It does not pretend to provide multiplayer, streaming, tickets or playback.

CORE EXPERIENCE
Open directly into the live chooser in English with a compact Mood control (Funny, Epic, Emotional, Dark), a Time limit control (Up to 2 hours, Up to 2.5 hours, Any), progress such as "1 of 7", one current cinematic card, accessible details, Not Tonight, Want to Watch, Must Watch and Undo. Defaults are Epic and Any. Keep the current artwork, title and primary actions visible and usable without an initial downward scroll.

INTERACTION AND STATE
- Each game samples exactly 7 eligible stable IDs without replacement from the 25-film pool. The user never has to process 25 films and progress never says "of 25".
- Swipe left or press Not Tonight, swipe right or press Want to Watch, swipe up or press Must Watch. Tapping Details reveals year, genres, runtime, series, principal character names, a short spoiler-free original synopsis, mood tags and newcomer fit without navigating away.
- Lock input during transitions. A film resolves exactly once. Undo restores the prior film and vote without resampling or reordering.
- Rank candidates using Must Watch > Want to Watch > Not Tonight, then selected mood and time fit. When at least two films are positive, run a compact Final Poster Battle with no more than two head-to-head choices among the top three, then show the result immediately. When exactly one is positive, select it directly. When none are positive, show a gentle no-match panel with a Spin the Portal action that randomly selects one of the seven eligible films, or Replay for a new round.
- Result shows Tonight's Movie, artwork, title, year, runtime, approximate finish time based on the device clock, spoiler-free reason, newcomer fit, one backup, Watch Later, Replay and Share before optional details. Watch Later persists locally and never claims to book or stream anything.
- Persist locale, filters, round IDs and order, current index, votes, battle state, result and Watch Later locally. Refresh preserves the current game. Replay is the only normal action that samples a new seven.
- This is single-user only. Do not add Person 1 / Person 2, pass-the-phone, private ballots, a handoff screen, login or fake group synchronization.

VISUAL AND CONTENT DIRECTION
Create a refined midnight-cinema interface with ink-black space, smoky indigo, soft ivory type, restrained electric-coral accents, subtle film grain made in CSS and one tactile poster card. Do not imitate Marvel branding, official poster typography, theatrical one-sheets, studio title treatments or a streaming-service catalogue. Keep information hierarchy editorial and compact rather than a dashboard grid.

Produce exactly 25 final original 2:3 portrait WebP artworks at 800 x 1200 in public/posters/poster-001.webp through poster-025.webp, matched one-to-one to P01 through P25. Generate sequentially in three build-time batches of at most 10: P01-P10, P11-P20, P21-P25. Complete and save a batch before the next. Retry only missing or invalid stable IDs. Final public/posters contains exactly these 25 WebP files and no PNG masters or superseded copies. Each file must be publicly loadable, non-empty, exact 2:3, no more than 300 KB and visually unique.

GLOBAL ART BIBLE: photoreal cinematic editorial scenes with plausible physical light, deep atmosphere, original anonymous environments and human figures too distant or obscured to identify. No illustration, 3D render, collage, UI mockup, official poster, film still, third-party image, external URL, text baked into art, letters, title, logo, watermark, studio mark, actor or celebrity likeness, recognizable character, signature costume, weapon, prop, creature, emblem, color-block replica, franchise typography or living-artist imitation. High-level plot motifs may inspire an original scene, but never reconstruct a scene or composition from the film. All names and facts stay as accessible HTML outside the images.

CONTENT MANIFEST
P01 | /posters/poster-001.webp | Iron Man / 钢铁侠 | 2008 | 126 min | Action, Sci-Fi | Infinity Saga | Tony Stark, Pepper Potts, James Rhodes | A brilliant industrialist builds a new purpose from captivity and consequence. | moods=funny,epic | newcomer=excellent | IMAGE: an anonymous inventor silhouette in a rough desert workshop, scattered generic metal prototypes and one warm work light; no armor silhouette, glowing chest device, actor likeness or official key art.
P02 | /posters/poster-002.webp | Captain America: The First Avenger / 美国队长 | 2011 | 124 min | Action, Adventure | Infinity Saga | Steve Rogers, Peggy Carter, Bucky Barnes | A determined volunteer is transformed into a wartime symbol and tested by sacrifice. | moods=epic,emotional | newcomer=excellent | IMAGE: an original 1940s rail yard at dawn with anonymous volunteers boarding a troop train; no shield, uniform replica, actor likeness or propaganda-poster typography.
P03 | /posters/poster-003.webp | Thor / 雷神 | 2011 | 115 min | Action, Fantasy | Infinity Saga | Thor, Jane Foster, Loki | An exiled prince must learn humility while two worlds move toward conflict. | moods=funny,epic | newcomer=good | IMAGE: a lonely desert observatory beneath a vast thunderstorm and an anonymous traveler near scientific equipment; no hammer, cape, helmet or recognizable costume.
P04 | /posters/poster-004.webp | The Avengers / 复仇者联盟 | 2012 | 143 min | Action, Adventure | Infinity Saga | Tony Stark, Steve Rogers, Thor, Natasha Romanoff, Bruce Banner, Clint Barton | Unlikely heroes learn to cooperate when a global threat reaches New York. | moods=funny,epic | newcomer=good | IMAGE: a wholly original modern-city rooftop after rain with six small anonymous figures facing distant blue atmospheric light; no costumes, weapons, logos or official ensemble layout.
P05 | /posters/poster-005.webp | Guardians of the Galaxy / 银河护卫队 | 2014 | 121 min | Action, Comedy, Sci-Fi | Infinity Saga | Peter Quill, Gamora, Rocket, Groot, Drax | A mismatched band of fugitives discovers that trust may be their strongest weapon. | moods=funny,emotional | newcomer=excellent | IMAGE: anonymous travelers overlooking a luminous junk-port in a new nebula landscape, silhouettes only; no recognizable species, helmets, props or character poses.
P06 | /posters/poster-006.webp | Captain America: The Winter Soldier / 美国队长2 | 2014 | 136 min | Action, Thriller | Infinity Saga | Steve Rogers, Natasha Romanoff, Sam Wilson, Bucky Barnes | A loyal soldier questions the system when hidden power turns allies into suspects. | moods=epic,dark | newcomer=good | IMAGE: an anonymous runner crossing a rainy civic bridge under surveillance-like reflections; no shield, mask, wings, uniform replica or actor likeness.
P07 | /posters/poster-007.webp | Avengers: Age of Ultron / 复仇者联盟2 | 2015 | 141 min | Action, Sci-Fi | Infinity Saga | Tony Stark, Steve Rogers, Thor, Natasha Romanoff, Bruce Banner, Clint Barton | A peacekeeping experiment creates a crisis that forces the team to confront its fears. | moods=epic,dark | newcomer=limited | IMAGE: a fractured fictional European street at blue hour with anonymous rescuers moving through dust and distant generic machine lights; no robot likeness or team costumes.
P08 | /posters/poster-008.webp | Ant-Man / 蚁人 | 2015 | 117 min | Action, Comedy | Infinity Saga | Scott Lang, Hope van Dyne, Hank Pym | A well-meaning thief gets one small chance to become a dependable hero. | moods=funny,emotional | newcomer=excellent | IMAGE: a tiny anonymous explorer crossing an enormous kitchen worktop beside a paperclip and breadcrumb; no helmet, suit design, logo or actor face.
P09 | /posters/poster-009.webp | Captain America: Civil War / 美国队长3 | 2016 | 147 min | Action, Drama | Infinity Saga | Steve Rogers, Tony Stark, Bucky Barnes, T’Challa | Political pressure and personal history split trusted allies into opposing sides. | moods=epic,emotional | newcomer=limited | IMAGE: a fictional airport runway at sunset divided by a long white line, two distant groups of anonymous people on opposite sides; no costumes, shields or weapons.
P10 | /posters/poster-010.webp | Doctor Strange / 奇异博士 | 2016 | 115 min | Fantasy, Adventure | Infinity Saga | Stephen Strange, Christine Palmer, Wong, the Ancient One | An injured surgeon discovers a discipline that challenges everything he believes about reality. | moods=epic,dark | newcomer=excellent | IMAGE: an anonymous scholar in a coat walking through an original city whose streets fold into geometric reflections; no cape, magic symbols, actor face or official orange portal.
P11 | /posters/poster-011.webp | Spider-Man: Homecoming / 蜘蛛侠：英雄归来 | 2017 | 133 min | Action, Comedy | Infinity Saga | Peter Parker, Adrian Toomes, Ned Leeds, Michelle Jones | A young hero struggles to balance school life with proving he is ready for bigger responsibility. | moods=funny,emotional | newcomer=excellent | IMAGE: a teenage silhouette with an ordinary backpack on a Queens-like rooftop at dusk, looking across apartment lights; no mask, web pattern, suit or actor likeness.
P12 | /posters/poster-012.webp | Thor: Ragnarok / 雷神3 | 2017 | 130 min | Action, Comedy, Fantasy | Infinity Saga | Thor, Loki, Valkyrie, Bruce Banner, Hela | A displaced prince assembles unlikely allies to save his home from destruction. | moods=funny,epic | newcomer=good | IMAGE: a new neon alien arena city with two anonymous travelers crossing a bridge under saturated cyan and coral light; no helmets, hammers, capes or character likenesses.
P13 | /posters/poster-013.webp | Black Panther / 黑豹 | 2018 | 134 min | Action, Drama | Infinity Saga | T’Challa, Nakia, Shuri, Okoye, Erik Killmonger | A new king must decide how an advanced nation should face the wider world. | moods=epic,emotional | newcomer=excellent | IMAGE: an original Afrofuturist mountain city at sunrise with an anonymous ceremonial procession in non-specific contemporary clothing; no feline mask, spear or costume replica.
P14 | /posters/poster-014.webp | Avengers: Infinity War / 复仇者联盟3 | 2018 | 149 min | Action, Sci-Fi | Infinity Saga | The Avengers, the Guardians, Thanos | Heroes across Earth and space race to stop a threat with universe-wide consequences. | moods=epic,dark | newcomer=limited | IMAGE: a cosmic storm opening above an original wooded valley while small anonymous rescuers gather below; no villain likeness, gauntlet, costumes or official ensemble composition.
P15 | /posters/poster-015.webp | Captain Marvel / 惊奇队长 | 2019 | 123 min | Action, Sci-Fi | Infinity Saga | Carol Danvers, Nick Fury, Maria Rambeau, Talos | A powerful pilot pieces together a hidden past during an interstellar conflict. | moods=funny,epic | newcomer=good | IMAGE: a 1990s desert airfield at night under a luminous comet trail, anonymous pilot seen from behind; no suit colors, insignia, actor face or branded aircraft.
P16 | /posters/poster-016.webp | Avengers: Endgame / 复仇者联盟4 | 2019 | 181 min | Action, Drama | Infinity Saga | The surviving Avengers | After devastating loss, the remaining heroes attempt one final, costly path forward. | moods=epic,emotional | newcomer=limited | IMAGE: dawn entering a ruined fictional operations hall with empty chairs and a small anonymous group reunited in the distance; no costumes, props or official lineup.
P17 | /posters/poster-017.webp | Spider-Man: Far From Home / 蜘蛛侠：英雄远征 | 2019 | 129 min | Action, Comedy | Infinity Saga | Peter Parker, Michelle Jones, Nick Fury, Quentin Beck | A school trip becomes a test of grief, trust and inherited responsibility. | moods=funny,emotional | newcomer=good | IMAGE: an original European canal at blue hour with an unattended student backpack and an unnatural ripple in the water; no masks, suits, actors or landmark copying.
P18 | /posters/poster-018.webp | Black Widow / 黑寡妇 | 2021 | 134 min | Action, Spy Thriller | Multiverse Saga | Natasha Romanoff, Yelena Belova, Alexei Shostakov, Melina Vostokoff | A fugitive confronts the family and program that shaped her before she became an Avenger. | moods=funny,dark | newcomer=good | IMAGE: a snowy safehouse table with two anonymous sisters in soft silhouette and scattered non-legible coded papers; no actor likeness, suit, insignia or readable text.
P19 | /posters/poster-019.webp | Shang-Chi and the Legend of the Ten Rings / 尚气与十环传奇 | 2021 | 132 min | Action, Fantasy | Multiverse Saga | Shang-Chi, Katy, Xu Wenwu, Xialing | A quiet life is interrupted when a son must face his family’s powerful legacy. | moods=funny,epic | newcomer=excellent | IMAGE: a misty original mountain village with an anonymous martial artist practicing beside a reflecting pool; no rings, actor likeness, costume replica or signature weapon.
P20 | /posters/poster-020.webp | Eternals / 永恒族 | 2021 | 156 min | Sci-Fi, Drama | Multiverse Saga | Sersi, Ikaris, Thena, Kingo, Phastos | Long-hidden protectors reunite as ancient duty collides with affection for humanity. | moods=epic,emotional | newcomer=good | IMAGE: a monumental original coastal monolith at golden hour with a diverse group of anonymous observers in everyday silhouettes; no superhero costumes or actor faces.
P21 | /posters/poster-021.webp | Spider-Man: No Way Home / 蜘蛛侠：英雄无归 | 2021 | 148 min | Action, Fantasy | Multiverse Saga | Peter Parker, Doctor Strange, Michelle Jones, Ned Leeds | A desperate attempt to repair a public crisis opens consequences across realities. | moods=funny,emotional | newcomer=limited | IMAGE: a rain-soaked fictional city crossroads seen from above with three anonymous rooftop silhouettes; no masks, webs, suits, capes or recognizable architecture.
P22 | /posters/poster-022.webp | Doctor Strange in the Multiverse of Madness / 奇异博士2 | 2022 | 126 min | Fantasy, Horror | Multiverse Saga | Stephen Strange, America Chavez, Wanda Maximoff, Wong | A traveler who can cross realities becomes central to a dangerous pursuit through alternate worlds. | moods=epic,dark | newcomer=limited | IMAGE: an original red-lit archive with fractured doorways revealing different abstract climates, one anonymous traveler centered; no cape, crown, magic glyphs or actor faces.
P23 | /posters/poster-023.webp | Black Panther: Wakanda Forever / 黑豹2 | 2022 | 161 min | Action, Drama | Multiverse Saga | Shuri, Ramonda, Okoye, Nakia, Namor | A grieving nation protects its future while confronting a powerful hidden civilization. | moods=epic,emotional | newcomer=limited | IMAGE: an original coastal future-city memorial at blue hour, anonymous figures setting floating lights on water; no masks, spears, costumes or actor likenesses.
P24 | /posters/poster-024.webp | Guardians of the Galaxy Vol. 3 / 银河护卫队3 | 2023 | 150 min | Action, Comedy, Drama | Multiverse Saga | Peter Quill, Rocket, Gamora, Groot, Drax, Nebula, Mantis | The team risks everything on a mission rooted in one friend’s painful history. | moods=funny,emotional | newcomer=limited | IMAGE: an original organic space-station corridor with six anonymous mismatched travelers moving toward daylight; no recognizable species, costume, actor or official group pose.
P25 | /posters/poster-025.webp | Deadpool & Wolverine / 死侍与金刚狼 | 2024 | 128 min | Action, Comedy | Multiverse Saga | Wade Wilson, Logan | Two reluctant allies collide on a chaotic mission with reality-level stakes. | moods=funny,epic | newcomer=good | IMAGE: a desolate fictional roadside with two anonymous travelers, mismatched red and mustard luggage, and playful action debris; no masks, claws, suits, actor likenesses or official color-block poster layout.

OUTCOME
A decisive, spoiler-safe movie recommendation reached in a short session, with one backup and a clear reason grounded in the user's mood and time limit.

ONE-SENTENCE INSTRUCTION
Swipe left to skip, right to shortlist, or up to mark a must-watch.

TASK-SPECIFIC REQUIREMENTS
- generatedRealImageAssets=true; assetCountPerApp=25; roundItemCountPerApp=7.
- Treat the manifest above as the source of truth. Keep factual title, year, runtime, series and character fields accurate; the synopsis wording and all artwork must be original. Add a small bilingual "Unofficial decision tool; not affiliated with Marvel or Disney" note in Details or About, not as a blocking screen.
- Support touch, mouse and keyboard parity, visible focus, bilingual descriptive alt text, aria-live feedback and reduced motion. Provide localized image fallback, storage-unavailable, insufficient-eligible-films and generic error states.
- Do not use official posters, film stills, trailers, external images, streaming links, pirated links, runtime image generation, accounts, analytics, tracking, uploads, payments or external APIs.

IMPLEMENTATION INSTRUCTIONS

Treat this specification as the final implementation brief and build the complete app now.

Open directly into the live app experience. Do not add a splash screen, opening cover, welcome page or separate onboarding flow.

Include exactly one concise sentence that explains how to play or use the app. Use the sentence provided under ONE-SENTENCE INSTRUCTION. Show it inside the live app interface, not on a separate opening screen.

Internationalization is required. Implement a lightweight built-in i18n layer supporting exactly two locales: English (en) and Simplified Chinese (zh). The app must always open in English and must never auto-detect or follow the browser, device or system language. Provide one clear EN / 中文 language toggle. Every user-facing string, including the one-sentence instruction and all loading, empty, success, error and result states, must have complete English and Chinese versions. Switching languages must update the entire interface without mixed-language text or untranslated fallback strings.

Let Eazo adapt the app to its actual host and available viewport. Do not hard-code or target a particular browser size, device size, viewport width or height, App frame size, root-height formula, or host-container CSS implementation. In the live preview, keep the current primary action easy to discover and usable without requiring an initial downward scroll; avoid horizontal overflow and avoid decorative layers blocking required controls. Optional detail may scroll. Keep active media and secondary copy compact enough that the next action remains visible. In result states, show the summary plus Replay and Share before optional detail. Do not eagerly render a large collection of full-size result images in one long page; use a compact summary, carousel, pagination, expansion, or virtualization. Use accessible touch targets.

Respect the host safe areas for iPhone notches, Dynamic Island, the status bar and the bottom home indicator in the initial implementation, before the first preview. Keep the header, language toggle, primary controls and result actions entirely inside the usable safe area. In the standard Eazo mobile host, use `padding-top: max(56px, env(safe-area-inset-top, 0px))` and `padding-bottom: max(34px, env(safe-area-inset-bottom, 0px))`, or Eazo's current official safe-area equivalent. These are safe-area insets only, not fixed viewport or App-frame dimensions; continue to let Eazo adapt the overall width and height. Make sure flex children can shrink inside the remaining usable area and that required controls are not covered or pushed off screen.

Use Eazo's built-in defaults and official platform capabilities. Do not add unrelated features or expand the scope beyond this specification.

When implementation is complete, provide a working preview for QA.

REAL-IMAGE RUNTIME DELIVERY, DISPLAY AND PREDECODE

This is a generated real-photo asset app, so implement all requirements in this section before providing the first preview. Apply them only to this app. Do not turn them into a reusable gameplay template and do not add card, swipe, random-round, seven-step, or duel mechanics unless this app's own specification requires them.

During the build, the image generator may create temporary high-resolution masters, but the final public runtime directory must contain exactly the required N high-quality WebP assets and no superseded PNG copies. Keep every stable content ID and every data, cover-preview and fallback path mapped to its matching `.webp` file. Never send multi-megabyte PNG masters to the user. For a 2:3 image displayed at up to about 360 CSS pixels wide in the standard Eazo mobile host, use 800 x 1200 WebP at about quality 82 as the proven baseline. If this app renders images at a different size or ratio, export at roughly twice the actual maximum rendered CSS width while preserving the exact intrinsic ratio. Target 200 KB or less per runtime image and treat 300 KB as the hard maximum unless this specification explicitly justifies a larger asset.

Serve these local WebP files directly from stable `public/` URLs and do not make image visibility depend on the `/_next/image` optimization service. If this Next.js project has an `images` configuration, keep `images.unoptimized: true` for this direct-static-asset path. Prefer a native `<img>` for the visible card, comparison and result image, with the current image loaded eagerly and `decoding="async"`. For a height-driven 2:3 layout, use an image that participates in layout, such as `height: 100%; width: auto; max-width: 100%; object-fit: contain; aspect-ratio: 2 / 3`. Never combine `next/image` `fill` with a parent whose width is `auto` or content-derived: the absolutely positioned image does not size that parent and the image region can collapse to zero width. If `fill` is used anywhere else, its positioning parent must have explicit non-auto width and height and the rendered image must be proven to have non-zero dimensions.

When an active round or immediate sequence is small enough that its compressed runtime images total about 1 MB or less, start preloading and decoding every remaining image in that active round as soon as the round is created. Use `new Image()`, assign the direct WebP URL, call `decode()` when available, and keep a module- or session-level `Set` of warmed source URLs so each image is fetched and decoded only once. This rule applies to the active round, including images that may appear in comparisons or results, not to the complete 25-image pool. For a larger immediate sequence, use a bounded byte-budget window rather than preloading the whole pool, and make it wide enough that rapid consecutive actions never expose a blank or waiting image.

Keep a clean named fallback for load failure. Do not add a runtime image-generation API, external URL, hotlink or third-party image service.