6.8 KiB
Grace portfolio visual refinement
Audit and preservation
The existing Next.js 14 App Router application was refined in place. The main visual problem was the use of complete, vertical presentation boards as hero and project imagery, together with overlapping bordered panels. The site now uses isolated architectural renders, open alternating project layouts, quieter rules, and a separate full-sheet viewer.
All five featured projects, additional projects, descriptions, roles, highlights,
years, locations, awards, experience, education, skills, software, metrics,
contact details, English/Arabic copy, PDF actions, theme controls, and routes are
retained. The English and Arabic dictionaries were compared programmatically
against their pre-edit snapshots, excluding the intentional image fields.
Original board alt text is retained in sheetImageAlt.
Image architecture
Project.coverImageis optional; the component falls back to the retained legacyimagefield when a cover has not been assigned.sheetImageis the complete presentation board, loaded only when the viewer opens.additionalSheetImagessupports the second Bab Touma sheet.coverOrientationkeeps tower renders portrait and wider scenes landscape.getHeroImage()selects/images/site/grace-hero-main.webpif it exists at build time. Otherwise it uses/images/site/grace-hero-fallback.webp.- The current hero fallback is a real Marota City S160 exterior render, cropped from the original board. Its visible caption and alt text identify that project. Supply the preferred image and rebuild; if it depicts another project, update the hero caption and alt text to identify that project.
- No stock imagery, generated imagery, fabricated image detail, or new application dependencies were introduced.
All paths in this table are relative to public/images/.
| Project | Cover | Full board | Original crop, x/y/width/height |
|---|---|---|---|
| Marota City S160 | projects/marota-s160-cover.webp |
projects/marota-s160-board.webp |
portfolio-pages/marota-city-s160.webp: 139 / 799 / 593 / 852 |
| Marota City S174 | projects/marota-s174-cover.webp |
projects/marota-s174-board.webp |
portfolio-pages/marota-city-s174.webp: 90 / 1520 / 606 / 816 |
| Luxury Hotel | projects/luxury-hotel-cover.webp |
projects/luxury-hotel-board.webp |
portfolio-pages/luxury-hotel.webp: 91 / 798 / 1253 / 745 |
| Regal Pool | projects/regal-pool-cover.webp |
projects/regal-pool-board.webp |
portfolio-pages/regal-pool.webp: 998 / 2081 / 339 / 189 |
| Bab Touma Square | projects/bab-touma-cover.webp |
projects/bab-touma-board.webp |
Original portfolio page 10: 578 / 1309 / 724 / 463 |
projects/bab-touma-perspectives-board.webp contains the original page 10
perspectives, alongside the preserved plan board from page 9. The original
portfolio PDF and all legacy public image paths remain available.
The PDF embeds the same source-resolution page images as the existing extracted pages; it does not contain higher-resolution individual renders.
Owner image replacements
The missing preferred hero is public/images/site/grace-hero-main.webp.
All five covers now exist and work. Higher-resolution original renders are
recommended, especially Regal Pool (the available crop is only 339 × 189).
Replace the corresponding cover files with the owner's originals; preserve
their aspect ratio or update coverOrientation. The current crops have not
been artificially upscaled or reconstructed.
Motion, navigation, and accessibility
Section-heading rules now use their own Reveal intersection state instead of a page-load animation. Image reveals respect reading direction. Route entrances use opacity and a 12px translation over 420ms. Reduced-motion preferences reveal all content immediately and disable transforms.
The native dialog viewer provides full-sheet fit, detail zoom, original-image links, localized controls, optional sheet navigation, Escape, focus return, and body-scroll restoration. Without JavaScript, the sheet link opens the actual image. Mobile navigation retains its focus trap and makes the background inert.
Mobile projects stack image before copy; desktop alternates the image and copy. The full layout uses logical spacing for RTL/LTR. Contact values and links, Lucide icons, light/dark themes, and language switching are retained.
Domain and SEO
The default canonical origin is https://gracesalamoun.com. Known misspelled
and www production host overrides normalize to that origin. Other valid
environment origins remain supported. Canonical metadata, OpenGraph, Twitter,
JSON-LD, robots, and sitemap share this configuration. The social image uses the
resolved, existing hero asset rather than a missing preferred-file URL.
Files
Updated in this refinement: app/layout.tsx, app/portfolio.css,
components/home-page.tsx, components/project-card.tsx,
components/section-heading.tsx, components/site-shell.tsx,
components/mobile-nav.tsx, components/reveal.tsx,
data/portfolio/{types,shared,en,ar}.ts, data/seo.ts,
data/site-config.ts, and .gitignore.
New source files: components/project-sheet-viewer.tsx,
components/route-transition.tsx, data/portfolio-images.ts,
app/sheet-viewer.css, and this report. New public assets: five covers, six
boards, and the hero fallback listed above.
The repository already had unrelated and earlier working-tree changes when
the task began; those were preserved. Local browser scripts, screenshots,
content snapshots, and verification output are under ignored .artifacts/.
Validation
- TypeScript:
node node_modules/typescript/bin/tsc --noEmit --incremental falsepassed. - Production:
npm.cmd run buildpassed, generating all 13 static pages. - Lint:
npm.cmd run lintreaches the interactive ESLint setup prompt; no ESLint configuration or dependency exists, so a configured lint run is unavailable. - English/Arabic factual-content preservation comparison passed.
- Browser review uses the built application in local Chromium. Screenshots and
the detailed checks are saved in
.artifacts/visual-report.json. - All 58 browser assertions passed with no runtime or console errors. Both homepages were reviewed at 360, 390, 430, 768, 1024, 1280, 1440, and 1920px; both resume routes were also checked at mobile and desktop sizes. No horizontal overflow was found. Dialog fit/zoom/Escape/focus, mobile-menu focus and inert background, route navigation, dark mode, viewport-driven heading rules, and reduced motion were checked.
- Additional checks passed for language switching on the resume routes, the
four primary routes, both English redirects, the PDF, robots, and sitemap.
Supplemental section and project screenshots are in
.artifacts/detail-*.png. - Build warnings concern the existing webpack cache and stale Browserslist database; they do not prevent compilation.