Add changelog and agent guide

This commit is contained in:
2026-05-16 00:11:23 +01:00
parent f6af80e60d
commit 2fddb47166
2 changed files with 163 additions and 0 deletions

126
Agent.MD Normal file
View File

@@ -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
```

37
CHANGELOG.md Normal file
View File

@@ -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