Skip to content

docs: revise PRD and CLAUDE.md after tech-stack audit#6

Merged
ParseDotEXE merged 4 commits into
mainfrom
feat/tech-stack-revision-and-gallery
May 30, 2026
Merged

docs: revise PRD and CLAUDE.md after tech-stack audit#6
ParseDotEXE merged 4 commits into
mainfrom
feat/tech-stack-revision-and-gallery

Conversation

@thaimtl
Copy link
Copy Markdown
Collaborator

@thaimtl thaimtl commented May 30, 2026

  • Gemini: gemini-2.0-flash (text-only) -> gemini-3.1-flash-image-preview (Nano Banana 2); note no free tier, billing required, preview rate limits
  • Video pipeline: 3-keyframe assumption was unsupported (verified Higgsfield, Kling, Luma all cap at 2). Now start=real photo, end=final redesign; motion prompt creates the chaos. Chaos frame is storyboard-only.
  • generate-video API contract: frame1/2/3Base64 -> startFrameBase64 + endFrameBase64
  • Expo API routes need a running dev server (laptop up, same LAN for demo)
  • New scope: on-device persistence (expo-file-system + AsyncStorage) + /gallery screen + save-to-camera-roll (expo-media-library); RoomContext stays ephemeral, durable state in lib/storage.ts
  • Stack bumps: Expo SDK 51 -> 54/55, NativeWind v4
  • Clarify NativeWind = Tailwind compiled to RN styles (vanilla Tailwind is web-only)
  • Add Revision Notes / Key Technical Decisions blocks documenting the why

- Gemini: gemini-2.0-flash (text-only) -> gemini-3.1-flash-image-preview
  (Nano Banana 2); note no free tier, billing required, preview rate limits
- Video pipeline: 3-keyframe assumption was unsupported (verified Higgsfield,
  Kling, Luma all cap at 2). Now start=real photo, end=final redesign; motion
  prompt creates the chaos. Chaos frame is storyboard-only.
- generate-video API contract: frame1/2/3Base64 -> startFrameBase64 + endFrameBase64
- Expo API routes need a running dev server (laptop up, same LAN for demo)
- New scope: on-device persistence (expo-file-system + AsyncStorage) + /gallery
  screen + save-to-camera-roll (expo-media-library); RoomContext stays ephemeral,
  durable state in lib/storage.ts
- Stack bumps: Expo SDK 51 -> 54/55, NativeWind v4
- Clarify NativeWind = Tailwind compiled to RN styles (vanilla Tailwind is web-only)
- Add Revision Notes / Key Technical Decisions blocks documenting the why

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@thaimtl thaimtl requested a review from ParseDotEXE May 30, 2026 21:31
thaimtl and others added 2 commits May 30, 2026 17:38
…ion-and-gallery

# Conflicts:
#	documents/reroom_PRD_only.md
#	workflows/CLAUDE.md
…ty gallery

Sponsor-prize-driven scope change. Replaces the on-device-only storage with a
cloud architecture that uses MongoDB for what it's good at (queryable documents)
and Cloudinary for files (no GridFS / blobs-in-Mongo anti-pattern):

- Files (3 frames + 7s video) -> Cloudinary; returns CDN URLs
- Metadata + URLs -> MongoDB Atlas (redesigns collection)
- /gallery becomes a PUBLIC community feed (find().sort(createdAt desc)); no auth
- New API routes: POST /api/save-redesign (upload + insert), GET /api/gallery (feed)
- New lib modules: lib/mongo.ts, lib/cloudinary.ts (server/API-route only)
- New env vars: MONGODB_URI, CLOUDINARY_CLOUD_NAME/_API_KEY/_API_SECRET
- New server deps: mongodb, cloudinary
- On-device AsyncStorage demoted to optional session cache (not source of truth)
- Save-to-camera-roll (expo-media-library) retained on result screen
- Renamed useHiggsfield -> useVideoJob; cleaned stale "Higgsfield" refs to reflect
  Kling 3.0 via eachlabs

Cloud-save is non-blocking: if it fails, the user still sees their video.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Comment thread documents/reroom_PRD_only.md Outdated
Comment thread documents/reroom_PRD_only.md Outdated
Comment thread documents/reroom_PRD_only.md Outdated
**Core idea:** User scans their room → Gemini generates a chaos frame and a final redesign frame → all 3 frames are passed to Higgsfield → cinematic transition video of the room transforming.
**Name:** ReRoom
**Tagline:** *Point. Redesign. Watch it happen.*
**Core idea:** User scans their room → Gemini generates a chaos frame and a final redesign frame →
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

could work, need to see how good the video looks with only 2 frames

Comment thread documents/reroom_PRD_only.md Outdated
Comment thread documents/reroom_PRD_only.md Outdated
- Trim Gemini model decision to one concise line; remove gemini-2.0-flash
- Restore 3-frame storyboard (chaos frame kept for storyboard, not video keyframe)
- Fix Key Technical Decision #2 to reflect chaos frame is storyboard-only
- Update Kling 3.0 motion prompt to carry full transformation weight without a middle keyframe

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ParseDotEXE ParseDotEXE merged commit 4489c86 into main May 30, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants