Website improvements: FAQ, testimonials, use cases, and polish #20
Description
Website Improvement Suggestions
Based on a comprehensive review of the website, here are prioritized improvements to consider.
High Impact
1. Update Multi-Platform Feature Card
The FeatureGrid.astro still shows "Claude Desktop, ChatGPT+ Desktop, Cursor IDE" but we just added Gemini CLI to the installation section. Should be consistent across the site.
File: website/src/components/FeatureGrid.astro (line ~118)
2. Add FAQ Section
Common questions users likely have:
- "Does my data leave my computer?"
- "Does Obsidian need to be running?"
- "Can I use multiple vaults?"
- "What file types are supported?"
- "What if the AI makes a mistake?"
This addresses objections before they become blockers.
3. Add Testimonials/Social Proof
Real user quotes, tweet embeds, or community feedback. Right now the site says "trust us" but has no external validation. Even 2-3 short testimonials would help conversion.
4. Use Cases Section
Show specific workflows with before/after or step-by-step:
- Daily journaling with AI assistance
- Research and literature note synthesis
- Project/task management
- Writing and drafting assistance
Helps users see themselves using the product.
Medium Impact
5. "Quick Reference" Card
A compact, printable reference of all 12 MCP methods with one-line descriptions. Useful for developers and power users.
6. Vault Path Helper
Small note on how to find your vault path:
- macOS: Right-click vault folder → "Copy as Pathname"
- Windows: Shift+Right-click → "Copy as path"
This is a common friction point for new users.
7. Theme Toggle in Navigation
There's theme support in the code (Layout.astro lines 319-354) but no visible toggle in the nav. ThemeToggle.tsx exists but isn't used in the navigation.
8. Community Links
- Discord (if exists)
- Discussions on GitHub (more prominent)
- Related tools/ecosystem
- Contributing guide prominent link
Polish/Nice-to-Have
9. Animated Stats
Live-updating npm downloads or GitHub stars counter with subtle animation.
10. Mobile Video Optimization
The hero video autoplays. Consider lazy loading or "tap to play" on mobile for users on data limits.
11. Changelog Page
UpdateCallout exists but a full changelog would help power users track what's new.
12. Skip to Content Link
Accessibility improvement - hidden link for keyboard users to skip navigation.
Quick Win
Item #1 (Multi-Platform Feature Card) is a one-line fix that could be done immediately.