Add changelog and agent guide
This commit is contained in:
126
Agent.MD
Normal file
126
Agent.MD
Normal 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
37
CHANGELOG.md
Normal 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
|
||||
Reference in New Issue
Block a user