SkateSpots/FINAL_POLISH_BREAKDOWN.md
shakespeare.diy 27e14994b5 Import files from skate-spots project
Co-authored-by: shakespeare.diy <assistant@shakespeare.diy>
2026-06-15 20:04:15 +07:00

5.2 KiB

Final Polish - Breakdown & Budget

Available Budget: $5 USD
Date: December 30, 2025


📋 REQUESTED CHANGES

1. UI Consistency - Phone & Tablet Devices

What: Ensure all pages look good on mobile (375px-428px) and tablet (768px-1024px)
Pages to Check: All pages (20+)
Effort: 1.5-2 hours
Budget: $7-10

Issues to Fix:

  • Padding/margins on small screens
  • Text sizes readable on mobile
  • Cards don't overflow
  • Buttons accessible on touch
  • Forms usable on small screens
  • Bottom nav spacing
  • Header sizing

2. Terminology Changes Throughout App

What: Replace corporate/social media terms with skate-focused language

Changes Needed:

Current Term Replace With Locations
"Censorship-resistant" "Relay-powered" or "Community-controlled" About, Onboarding, multiple pages
"Like Instagram" "Connect with skaters" or "Find spots & community" Index, Onboarding, About
"Decentralized" "Community-run" or "Skater-owned" Multiple pages
Social media references Skateboarding-focused language All pages

Effort: 1 hour
Budget: $5
Files: ~10-15 files need text updates


3. About Page - Leaflet to OpenStreetMap

What: Change "Leaflet Maps" to "OpenStreetMap"
Effort: 2 minutes
Budget: FREE


4. Simplify Onboarding Page

What: Make onboarding less intimidating, more skater-friendly
Current: Too technical, feels like a manual
Goal: Quick, visual, skater-focused guide

Effort: 45 min - 1 hour
Budget: $4-5

Changes:

  • Shorter intro paragraphs
  • Less technical jargon
  • More visual (emojis, icons)
  • Skateboarding language
  • "3 steps to get rolling" not "how it works"
  • Friendly tone

5. Add wotr.relay.xyz as Default Relay

What: Set wotr.relay.xyz as default relay for all users
Where: AppProvider.tsx default config
Effort: 5 minutes
Budget: FREE


6. Relay Explanation Section in Settings

What: Add "Why This Relay?" info section
Content: Explain wotr.relay.xyz and link to blog post
Effort: 15 minutes
Budget: $1


💰 TOTAL BREAKDOWN

Task Effort Budget
1. UI Responsive Polish 1.5-2 hrs $7-10
2. Terminology Changes 1 hr $5
3. Leaflet → OpenStreetMap 2 min FREE
4. Simplify Onboarding 1 hr $4-5
5. Default Relay 5 min FREE
6. Relay Explanation 15 min $1

TOTAL: 3.5-4.5 hours, $17-21


🎯 OPTIONS FOR $5 BUDGET

Option 1: Text-Only Changes ($5)

✅ Terminology changes (all pages)
✅ Simplify onboarding text
✅ Change Leaflet → OpenStreetMap
✅ Add default relay
✅ Add relay explanation
❌ Skip full responsive audit

Time: ~2 hours
Impact: HIGH - better messaging, less intimidating
Risk: Some mobile UI issues may remain


Option 2: Responsive Focus ($5)

✅ Full mobile/tablet UI audit
✅ Fix padding, sizing, spacing issues
✅ Ensure touch-friendly on all devices
❌ Skip text changes for now

Time: ~1.5 hours (focused audit)
Impact: MEDIUM - better UX on mobile
Risk: Terminology stays corporate


Option 3: Quick Wins ($5)

✅ Most critical terminology changes (10 locations)
✅ Simplify onboarding (keep it brief)
✅ Leaflet → OpenStreetMap
✅ Default relay + explanation
✅ Fix top 5 mobile UI issues

Time: ~2 hours
Impact: HIGH - best value
Risk: Some terminology and UI issues remain


🎯 MY RECOMMENDATION: Option 1

Why?

  • Fixes ALL terminology (complete messaging overhaul)
  • Makes onboarding friendly for skaters
  • Adds relay education
  • Better brand/tone for skateboarding community
  • UI is "good enough" currently (mostly works)

What You Get:

  • "Censorship-resistant" → "Community-controlled" (all pages)
  • "Like Instagram" → "Connect skaters IRL" (all references)
  • Simplified onboarding (skater-friendly)
  • wotr.relay.xyz as default with explanation
  • More skateboarding-focused language throughout

Trade-off: Some mobile padding/sizing tweaks deferred


📝 DETAILED STEPS (Option 1)

Step 1: Update Terminology (1 hour)

  1. Find all instances of "censorship-resistant" → replace
  2. Find "decentralized" → replace with "community-run"
  3. Remove "Instagram" references
  4. Update to skateboarding language
  5. Check About, Onboarding, Index, FAQ

Files: ~10-15 files

Step 2: Simplify Onboarding (45 min)

  1. Shorten intro paragraphs
  2. Remove technical jargon
  3. Make it skater-focused
  4. "Get rolling in 3 steps" approach
  5. Add more emojis/visual elements

Files: OnboardingPage.tsx

Step 3: Quick Fixes (15 min)

  1. Change Leaflet → OpenStreetMap in About
  2. Add wotr.relay.xyz to default relays
  3. Add relay explanation in Settings
  4. Link to moderation blog post

Files: AboutPage.tsx, AppProvider.tsx, SettingsPage.tsx


❓ WHICH OPTION?

A) Option 1 - Complete messaging/tone overhaul ($5) ⭐ RECOMMENDED
B) Option 2 - Full responsive UI audit ($5)
C) Option 3 - Mixed quick wins ($5)
D) Something else - tell me priority

Which would you like me to implement?