Description
Transform blank walls into immersive galleries without measuring tapes or mockups. RealWall Album mixes precise AR placement from RealityKit with SwiftUI controls so interior lovers, photographers, and merchandisers can preview frames at life size, save every layout as a reusable album, and capture media for clients—all in seconds.
### What You Can Do
- **Pin real art in AR**: Import photos from your library, drop handcrafted poster placeholders (City, Nature, Beach, Mountain, Abstract themes generated in-app), or place branded 2D/3D boxes you designed in Custom Box Manager.
- **Save and revisit rooms**: Every session stores attachments, transforms, and optional ARWorldMap data, so coming back to the same room instantly reloads the layout.
- **Capture proof in-app**: One tap triggers ReplayKit screen recording or grabs a snapshot. Galleries for Screenshots and Recordings keep revisions organized with context menus for deletion.
- **Control physical size**: The Photo Size Input asks for width/height before placing user photos, ensuring centimeter-accurate renders on the wall.
- **Build custom assets**: Create rectangle, circle, or oval presets with optional depth (0.01–10m) and rich imagery. Toggle 3D, set dimensions, attach reference art, and store unlimited variants.
- **Stay organized**: The Home hero card surfaces album counts, screenshots, and quick actions for media, albums, and custom box manager. Color-coded glassmorphism sheets keep navigation intuitive.
- **Work in any language**: LocalizationController powers instant switching between English and Indonesian from the home gear icon, while fallback strings remain in English per the codebase.
- **Test even on simulator**: `SimulatorARPlaceholderView` mimics AR experience so you can plan UI states without a LiDAR device.
### Why It’s Effortless
- Overlay controls (CreateControlsView & AlbumControlsView) float above RealityKit, keeping placement sources, save buttons, and exit actions reachable with one thumb.
- Albums, screenshots, recordings, and custom boxes are persisted via `AlbumStorage`, `MediaStorage`, and `CustomBoxStorage`, so nothing is lost between sessions.
- Protective dialogs confirm cancellations, while progress and badges (GlassStatusBadge, StatBadge) surface status at a glance.
- Works offline: no login, servers, or background analytics in the Swift files.
## How to Use (Short Version)
1. Launch RealWall Album and tap **Create Gallery** on the hero card.
2. Move your device to scan the wall; follow the scan hint overlay.
3. Select a content source (Photos picker, Poster placeholder, Custom Box). If needed, input physical size.
4. Tap the wall to place, pinch to scale, and drag to refine spacing. Switch poster themes or custom assets anytime.
5. Hit **Save Album** to store attachments + ARWorldMap. Confirm the name and continue editing.
6. Use **Screenshot** or **Record** in Album mode to capture proof. Review them later from the home Quick Actions.
7. Reopen saved galleries from the Album list—the app reloads placements and transforms automatically.