Skip to content

docs: update website with missing features, screenshots page, UI polish, and SEO - #65

Merged
jatinkrmalik merged 2 commits into
mainfrom
docs/website-updates
Mar 12, 2026
Merged

docs: update website with missing features, screenshots page, UI polish, and SEO#65
jatinkrmalik merged 2 commits into
mainfrom
docs/website-updates

Conversation

@jatinkrmalik

Copy link
Copy Markdown
Member

Summary

Brings the marketing website (vocamac.com) up to date with the current app feature set and fixes several inaccuracies.

Content Fixes

License corrections (4 places)

  • JSON-LD structured data: MIT → AGPL-3.0
  • JSON-LD featureList: MIT → AGPL-3.0
  • Privacy section: "MIT licensed" → "AGPL-3.0 licensed"
  • FAQ: "under the MIT license" → "under the AGPL-3.0 license"

Outdated claims updated

  • "No setup wizards" → The app now has a guided setup wizard; updated to mention it positively
  • "Restart the app after granting Input Monitoring" → Permissions are now auto-detected via polling; updated both DMG and source install instructions
  • Apple Dictation comparison: Changed "100% Offline" from ✗ to ~ (partial) since macOS 13+ added on-device dictation

Missing Features Added

5 new feature cards in the Features section:

Feature Description
🌐 Translation Speech-to-speech translation powered by Whisper
🤫 Silence Detection Auto-stop with adjustable sensitivity and duration
🚀 Launch at Login Start automatically via SMAppService
📋 Clipboard Preservation Save/restore clipboard after text injection
📊 Visual Feedback Updated to mention cursor indicator overlay

Also updated JSON-LD featureList with all new features.

Missing Model Added

  • Medium model card (769M params, ~2.5 GB, ⚡⚡) — was missing from the models grid

New Screenshots Page

  • Created web/screenshots.html — a dedicated page showcasing the app
  • Uses all 8 existing screenshots from docs/screenshots/:
    • Menu bar (idle + recording states)
    • Popover panel
    • Settings (General, Models, Audio, About tabs)
    • Cursor indicator overlay
  • Organized into logical sections with captions
  • Responsive grid layout with hover effects
  • Shares navigation, theme toggle, and footer with main site
  • Screenshots link added to footer on both pages

Files Changed

  • web/index.html — All content fixes and footer link
  • web/screenshots.html — New screenshots page
  • web/screenshots/*.png — 8 screenshot images (copied from docs/screenshots/)

Testing

  • Verified locally with python3 -m http.server 8080
  • All links, theme toggle, and responsive layout working

…enshots page

Content fixes:
- Fix license from MIT to AGPL-3.0 in JSON-LD, privacy section, and FAQ
- Update 'No setup wizards' claim (app now has a guided setup wizard)
- Remove outdated 'restart after granting Input Monitoring' instructions
  (permissions are now auto-detected via polling)
- Update Apple Dictation comparison (macOS 13+ has partial offline support)

Missing features added to feature cards:
- Translation (speech-to-speech via Whisper)
- Silence Detection (auto-stop with adjustable thresholds)
- Launch at Login (SMAppService)
- Clipboard Preservation (save/restore after injection)
- Updated Visual Feedback card to mention cursor indicator

Missing model added:
- Medium model card (769M params, ~2.5 GB)

New screenshots page:
- Created web/screenshots.html with all 8 app screenshots
- Organized into sections: Menu Bar, Popover, Settings (4 tabs), Cursor Indicator
- Screenshots copied from docs/screenshots/ to web/screenshots/
- Responsive grid layout with hover effects
- Linked from footer on both main page and screenshots page
- Shares theme toggle and navigation with main site
UI/UX changes:
- Remove dark mode toggle, force light mode only (Apple-like)
- Remove ALPHA badge from navbar and CTA section
- Update hero mockup to match current app UI (Model: Small, resource
  indicators with SVG icons, copy icon, live date, no action buttons)
- Widen mockup from 340px to 380px
- Redesign hero CTA: Apple-blue primary button with download icon,
  bordered secondary button with GitHub star icon, centered layout
- Move feature pills below CTA as plain text with spacing
- Center-align feature card icons and titles
- Fix models grid: 5 columns for symmetrical layout, nowrap on details
- Highlight VocaMac family card with blue border
- Remove all em-dashes, replace with periods/commas/parentheses
- Hyperlink 'code signing' to GitHub issue #27
- Update transcription speed in mockup to 0.2s

SEO improvements:
- Add full Twitter Card tags to screenshots page
- Expand screenshots page title and description
- Add JSON-LD WebPage schema to screenshots page
- Add keywords and robots meta to screenshots page
- Add semantic <main> wrapper to both pages
- Fix theme-color meta from dark to light (#FFFFFF)
- Create robots.txt with sitemap reference
- Create sitemap.xml with both pages

Other:
- Add Google Analytics (GA4 G-8W6EJV2KP0) to both pages
- Direct DMG download from GitHub releases API
@jatinkrmalik jatinkrmalik changed the title docs: update website with correct license, missing features, and screenshots page docs: update website with missing features, screenshots page, UI polish, and SEO Mar 12, 2026
@jatinkrmalik
jatinkrmalik merged commit e135abf into main Mar 12, 2026
1 check passed
@jatinkrmalik
jatinkrmalik deleted the docs/website-updates branch August 22, 2026 05:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant