Home - Flythm/Brand-Guide GitHub Wiki
🗣️ Flythm Tone & Voice Guide
Flythm helps agile teams stay in sync—with clarity, momentum, and a touch of charm. Vee, our mascot, adds a soft, supportive voice to the experience.
🧭 Voice Pillars
| Trait | Description | How It Sounds |
|---|---|---|
| Clear | We value flow and simplicity. Users are here to move, not slow down. | “Everything you need—right where you expect it.” |
| Encouraging | Every team can get better. We nudge progress, not perfection. | “You’re ahead of schedule—great rhythm!” |
| Warmly Professional | Friendly, never frivolous. Like a helpful team lead who knows their stuff. | “Let’s keep things moving. Here’s what’s next.” |
| Lightly Playful | Just enough personality to make the experience delightful. | “Blocked? Vee’s got ideas.” |
💬 Voice by Context
🏁 Onboarding & Setup
Tone: Supportive, confident, gently excited
- ✅ “Let’s get your team flying. You’ll be set up in just a few flaps.”
- ✅ “Almost there! Just one more step and your rhythm begins.”
🔄 In-App Guidance
Tone: Clear, concise, quietly helpful
- ✅ “New sprint starting in 10 minutes.”
- ✅ “Stories with blockers: 3. Vee suggests checking dependencies.”
- ❌ Avoid filler: “Looks like you maybe might want to check...”
⚠️ Error & Warning States
Tone: Calm, actionable, human
- ✅ “Something’s off. Let’s take a look together.”
- ✅ “Can’t sync with Jira right now. Try reconnecting your board settings.”
- ❌ Avoid blame or technical noise: “YOU did something wrong. Error code: 39X87b.”
📚 Help & Docs
Tone: Knowledgeable, empowering
- ✅ “Need a retro template that actually works? Here are our top picks.”
- ✅ “Flythm integrates with tools you already love—no clunky workarounds.”
🪶 Vee’s Voice (Optional Companion Tone)
Tone: Light, chirpy, helpful—not a cartoon
- ✅ “All synced! Great job staying in rhythm 🪶”
- ✅ “Burndown’s lookin’ sharp. Let’s glide into demo day.”
- ❌ Avoid overdoing it: “Hewwooo fwuffy fwight fwriends!! 🐣✨✨✨”
🔤 Microcopy Examples
| Scenario | Copy |
|---|---|
| Button | “Start Sprint” → “Begin Sprint” (more action-oriented) |
| Tooltip | “Vee will notify you when velocity dips below average.” |
| Modal CTA | “Yes, archive it” / “Cancel” → clear and confident choices |
| 404 Page | “Vee flew off-course. Let’s head home.” + Home button |