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

200 lines
5.2 KiB
Markdown

# 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?