Quick Start
Choose your path based on how much time you have:
If you have 5 minutes
Browse the pattern summaries to understand the critical issues facing Nostr UX.
Quick takeaway: Focus on getting users to value fast, showing them good content, and making core actions reliable.
If you have 30 minutes
Pick the pattern that matches your biggest pain point:
- Users abandon during signup? → Pattern 1: Onboarding
- Empty feeds after signup? → Pattern 2: Content Discovery
- Posts disappearing? → Pattern 3: Core Interactions
- App feels slow/crashy? → Pattern 4: Performance
- Users overwhelmed by settings? → Pattern 5: Progressive Complexity
- Data loss when switching clients? → Pattern 6: Cross-Client Consistency
Each pattern includes concrete examples, anti-patterns to avoid, and validation checklists.
If you’re building from scratch
Read patterns in order (1-6). Each builds on principles from earlier patterns.
Start with:
- Foundation - Learn the validation framework
- Pattern 1: Onboarding - Get users to value quickly
- Pattern 2: Content Discovery - Show them good content
- Work through remaining patterns as you add features
If you want to see the evidence
Check the Research Methodology and References to see the 100+ sources backing these patterns.
Research foundation:
- Academic HCI research on social media UX
- Industry design systems (Apple HIG, Material Design)
- Nostr-specific data (retention metrics, user complaints)
- Mainstream app case studies (TikTok, Instagram, Bluesky, Discord)
If you want to ship fast
Jump straight to Quick Wins for high-impact, low-effort improvements you can ship this week.
Next Steps
- Browse the patterns that match your current priorities
- Learn the Validation Framework to make better feature decisions
- Apply the Implementation Guide to integrate these patterns
- Join the discussion on Nostr (search for #NostrUX)
- Share feedback by opening issues on GitHub
Remember: You don’t have to implement everything at once. Pick one pattern, validate it works, then move to the next.