Skip to content

docs: update CLAUDE.md and AGENTS.md for icon generation session #5

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
sparshsam wants to merge 1 commit into from
Closed

docs: update CLAUDE.md and AGENTS.md for icon generation session #5

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,23 @@ vercel --prod --scope sparsh-sams-projects

Vercel project is linked — just run from repo root. Auto-deploys on push to `main`.

## 2026-07-03 — Icon Generation & Branding Session

### Icon Assets
- 115 assets generated from `wordwise_light_mode.png` via Lanczos resampling
- Formats: Windows ICO, MSIX (11 types × 5 scales), Android mipmap, iOS `.iconset`, macOS `.icns`, Web favicons, PWA manifest icons, OG image, GitHub avatars
- Master source: `assets/branding/wordwise_light_mode.png`
- Generated output in: `assets/branding/` (favicons + iconset), `assets/msix/`, `assets/android/`, `assets/ios/`, `public/` (favicon.ico)

### Branding Updates
- README header: app icon via `<img>` at 72px, centered, from `assets/branding/icon.png`
- Footer: Kovina wordmark logo (bottom-left, linked to https://kovina.org)

### Favicon Fix
- Removed `favicon.svg` — no longer supported by modern browsers reliably
- Generated: `favicon.ico` (multi-size), `favicon-16x16.png`, `favicon-32x32.png`, `apple-touch-icon.png`
- Updated `views/index.html` and `views/archive.html`: link tags for PNG favicons, OG meta tags with regenerated 1200×630 image

## Domains & DNS

- **App**: wordwise.kovina.org
Expand Down
21 changes: 21 additions & 0 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,27 @@ Response: `{ word, phonetic, definition, example, partOfSpeech, audioUrl, backgr

`main` requires 1 approving review, dismisses stale reviews, enforces for admins. No force pushes or deletions.

## 2026-07-03 — Icon Generation & Branding Session

### Icon Assets (115 total from `wordwise_light_mode.png`)
- **Windows**: Multi-size ICO (16×16–256×256)
- **MSIX Store**: 11 asset types × 5 scales (50px–800px)
- **Android**: mipmap-hdpi through xxxhdpi + adaptive icons
- **iOS**: App icon set (20pt–1024pt)
- **macOS**: `.iconset` (16×16–512×512@2x)
- **Web**: favicon.ico + favicon-16×16 + favicon-32×32 + apple-touch-icon
- **PWA**: 192×192 + 512×512 manifest icons
- **Social**: OG image (1200×630) + GitHub avatars + header icon

### Branding
- README header: app icon (72px centered) from `assets/branding/icon.png`
- Kovina wordmark logo added to footer (bottom-left, hyperlinked to kovina.org)

### Favicon Migration (SVG -> PNG)
- Removed `favicon.svg`, replaced with real PNG favicons generated from master source
- Enforced PNG favicon references in `views/index.html` and `views/archive.html`
- OG image regenerated at 1200×630

## Environment variables

| Variable | Source | Purpose |
Expand Down