Files
blackcanyontickets/styleGuide/microcopy-client.md
dzinesco 26a87d0d00 feat: Complete platform enhancement with multi-tenant architecture
Major additions:
- Territory manager system with application workflow
- Custom pricing and page builder with Craft.js
- Enhanced Stripe Connect onboarding
- CodeReadr QR scanning integration
- Kiosk mode for venue sales
- Super admin dashboard and analytics
- MCP integration for AI-powered operations

Infrastructure improvements:
- Centralized API client and routing system
- Enhanced authentication with organization context
- Comprehensive theme management system
- Advanced event management with custom tabs
- Performance monitoring and accessibility features

Database schema updates:
- Territory management tables
- Custom pages and pricing structures
- Kiosk PIN system
- Enhanced organization profiles
- CodeReadr integration tables

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-07-12 18:21:40 -06:00

2.8 KiB
Raw Permalink Blame History

📝 Crispy Goat Microcopy Guide Client Projects

For client-facing websites, our copy must reflect their tone, not ours. That said, all Crispy Goat projects share one thing: copy that feels human, intentional, and never robotic.


🧠 General Tone & Voice

  • Clear, direct, and human
  • Friendly but not casual unless the brand calls for it
  • No marketing clichés or AI-sounding nonsense
  • Helpful microcopy beats witty microcopy — but well take both
  • Tone should reflect confidence, not desperation

General Writing Principles

  • Keep sentences short and clear
  • Prefer active voice
  • Use contractions (“youre,” “well”) unless it feels off-brand
  • Avoid jargon unless its native to the audience
  • Avoid anything that sounds like ChatGPT 3.5 wrote it in a rush

✍️ Button Copy

Purpose Text Examples
Primary CTA Get Started, Book a Demo, Explore Plans
Secondary Learn More, See How It Works
Form Submit Send Message, Submit Inquiry
Danger / Delete Delete, Remove, Yes, Im Sure

📋 Form Microcopy

  • Labels must be clear and expected
    • Full Name, Email Address, Company
  • Placeholders may add a touch of tone
    • you@domain.com, Let us know what you're looking for
  • Error messages:
    • This field is required.
    • Please enter a valid email address.
    • Passwords must match.

📭 Empty States

  • No data:
    No records yet. Check back soon.
  • Search no match:
    We couldnt find anything. Try a different filter.
  • Form not started:
    Fill in the basics to get started.

🚫 What to Avoid

  • “Welcome to our website”
  • “Please dont hesitate to contact us”
  • “Innovative solutions for modern problems”
  • “We pride ourselves on excellence”
  • Any vague industry filler phrases

  • © 2025 [Client Name]. All rights reserved.
  • Built with care by Crispy Goat. (Optional tag)
  • Made in [Location] · Powered by [Tech or Platform] (Optional, clean)

🎨 Optional Personality Touches (Use Sparingly)

If the brand tone allows a little playfulness:

  • 404 Page:
    Looks like you took a wrong turn. Lets get you back.
  • Confirmation screen:
    We got your message. Someone will reach out soon.
  • Easter egg:
    Nice hover. Youve got good taste.

🧠 Summary

Client-facing copy should:

  • Reflect their brand voice first
  • Be smart and human, never stiff or soulless
  • Help the user, not distract them
  • Include subtle personality — but keep it their personality

If you're unsure, ask:

Would this sound natural coming from a person, or does it feel like filler?

If its filler, rewrite it.