From 2fddb471667381c8c8a3e2226e0632c7f354533b Mon Sep 17 00:00:00 2001 From: OpenCode Date: Sat, 16 May 2026 00:11:23 +0100 Subject: [PATCH] Add changelog and agent guide --- Agent.MD | 126 +++++++++++++++++++++++++++++++++++++++++++++++++++ CHANGELOG.md | 37 +++++++++++++++ 2 files changed, 163 insertions(+) create mode 100644 Agent.MD create mode 100644 CHANGELOG.md diff --git a/Agent.MD b/Agent.MD new file mode 100644 index 0000000..f3cea2d --- /dev/null +++ b/Agent.MD @@ -0,0 +1,126 @@ +# Agent Guide + +## Project + +New Optic is a multilingual premium marketing website for a trusted local optical shop in Temara, Morocco. + +The site is built with: + +- Next.js App Router +- React +- TypeScript +- Tailwind CSS +- Framer Motion + +## Commands + +```bash +npm install +npm run dev +npm run build +npm run start +``` + +Use `npm run build` before considering changes complete. + +## Important Files + +- `config/business.ts` contains editable business details, phone numbers, map URL, and asset paths. +- `messages/fr.ts` contains French copy. French is the default language. +- `messages/ar.ts` contains Arabic copy and must remain natural/readable with proper RTL support. +- `messages/en.ts` contains English copy. +- `components/SiteShell.tsx` controls active language and page composition. +- `components/Navbar.tsx` contains the sticky navigation and smooth-scroll behavior. +- `components/PhysicsButton.tsx` contains the magnetic/stretch CTA button behavior. +- `components/LiquidGlass.tsx` loads `liquidGL` only on desktop. +- `app/globals.css` contains global visual styling and mobile performance overrides. + +## Design Direction + +Keep the visual language premium, minimal, Apple-inspired, and calm. + +Prefer: + +- breathable spacing +- high contrast typography +- soft glass surfaces +- restrained gradients +- subtle motion +- clear conversion CTAs + +Avoid: + +- loud neon effects +- generic template sections +- fake testimonials +- overhyped luxury wording +- heavy mobile effects + +## Multilingual Rules + +- French is the default language. +- Arabic must use RTL layout correctly. +- Do not translate word-for-word. Keep copy natural in each language. +- When adding new copy, update all three translation files. + +## Mobile Performance Rules + +Mobile performance is important. + +- Do not load `liquidGL` or `html2canvas` on mobile. +- Avoid `backdrop-filter`, large blur layers, fixed backgrounds, and continuous animations below `1024px`. +- Use optimized images for mobile where possible. +- Keep touch interactions lightweight. + +## Business Facts + +Use only verified or provided facts: + +- Business name: New Optic +- Location: Temara, Morocco +- Area: Massira I / Rue Boujdour +- Phone: `05376-03279` +- WhatsApp: `+212 662-872002` +- Google Maps link: `https://maps.app.goo.gl/LeuFER6h887Cp5aG9` +- Trusted local optical shop since around 2011 +- Offers eye exams, repairs, prescription glasses, sunglasses, kids glasses, budget frames +- Offers original/authentic frames only +- Known for fair prices and local reputation + +Do not invent opening hours, testimonials, certifications, or brand partnerships. + +## Git / Release + +Remote repository: + +```txt +http://192.168.1.160:3000/oimwiodev/New-Optic.git +``` + +Main branch: + +```txt +main +``` + +Current release tag: + +```txt +v1.0.0 +``` + +## Commit Workflow + +When making project changes, commit them locally and push to the Gitea remote unless the user explicitly asks not to. + +Before committing: + +- Run `npm run build` for code changes. +- Review `git status` and `git diff`. +- Do not commit secrets or local environment files. + +Default push target: + +```txt +origin main +``` diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..8e873cc --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,37 @@ +# Changelog + +All notable changes to the New Optic website will be documented in this file. + +## [1.0.0] - 2026-05-16 + +### Added + +- Built the full multilingual New Optic marketing website. +- Added French, Arabic, and English language support. +- Added RTL layout support for Arabic. +- Added sticky glass navbar with mobile menu and smooth section scrolling. +- Added premium hero, about, services, collections, trust, contact, and footer sections. +- Added central editable business configuration in `config/business.ts`. +- Added structured translation files in `messages/`. +- Added WhatsApp, phone, map, and QR-code contact CTAs. +- Added Google Maps QR code asset. +- Added product collection imagery for prescription glasses, sunglasses, kids glasses, and budget frames. +- Added desktop-only `liquidGL` progressive enhancement for glass panels. +- Added magnetic/stretch CTA button interactions. +- Added mobile performance optimizations, including a compressed mobile background image. +- Added SEO metadata and local business JSON-LD. +- Added `Agent.MD` for future development guidance. + +### Changed + +- Optimized mobile rendering by disabling heavy blur, fixed backgrounds, ambient animations, and WebGL glass below desktop widths. +- Reworked collection cards from abstract placeholders to image-led product cards. +- Improved dark-section heading contrast. +- Corrected French typography and accents. + +### Verified + +- `npm run build` passes. +- Initial Gitea release created as `v1.0.0`. + +[1.0.0]: http://192.168.1.160:3000/oimwiodev/New-Optic/releases/tag/v1.0.0