diff --git a/BRANDING_GUIDE.md b/BRANDING_GUIDE.md new file mode 100644 index 0000000..6527748 --- /dev/null +++ b/BRANDING_GUIDE.md @@ -0,0 +1,552 @@ +# iRaceHub Branding Guide + +A comprehensive guide to promoting and representing iRaceHub in the iRacing community. + +--- + +## Table of Contents + +1. [Brand Overview](#brand-overview) +2. [Brand Mission & Values](#brand-mission--values) +3. [Visual Identity](#visual-identity) +4. [Logo Usage Guidelines](#logo-usage-guidelines) +5. [Color Palette](#color-palette) +6. [Typography](#typography) +7. [Branding Guidelines](#branding-guidelines) +8. [Driver Promotional Materials](#driver-promotional-materials) +9. [Social Media Guidelines](#social-media-guidelines) +10. [How to Promote in iRacing](#how-to-promote-in-iracing) +11. [Marketing Templates](#marketing-templates) + +--- + +## Brand Overview + +### What is iRaceHub? + +iRaceHub is an **open-source league management platform** designed specifically for the iRacing community. It empowers league owners to easily manage leagues, series, and seasons—while providing drivers with a modern, integrated experience for viewing schedules, results, standings, and competing in league-wide events. + +### Key Features Drivers Should Know About + +- **Real-time Schedule Sync** - Automatically syncs schedules with iRacing +- **Instant Results** - Race results are imported and displayed instantly +- **Live Standings** - Always see where you stand in real-time +- **Virtual Economy** - Participate in league-wide virtual money systems +- **Accessible Dashboards** - Simple, intuitive interface for drivers +- **Community-Driven** - Open source and built by the community, for the community + +### Why Drivers Should Promote iRaceHub + +- **Enhances League Experience** - Makes league management transparent and efficient +- **Open Source** - No vendor lock-in; free for all leagues +- **Community First** - Built to serve drivers, not extract value +- **Reliable** - Battle-tested in production leagues +- **Supporting Innovation** - Help shape the future of league management + +--- + +## Brand Mission & Values + +### Our Mission + +_To empower iRacing communities with accessible, transparent, and community-driven league management tools that enhance competition and foster meaningful racing experiences._ + +### Our Core Values + +| Value | Description | +| ----------------- | -------------------------------------------------- | +| **Transparency** | Open source and community-driven decision making | +| **Accessibility** | League management should be easy for everyone | +| **Community** | Built by racers, for racers | +| **Innovation** | Continuously improving the competitive experience | +| **Reliability** | Trustworthy platform for serious league operations | +| **Freedom** | No lock-in, self-hostable, owner-controlled | + +--- + +## Visual Identity + +### Brand Personality + +iRaceHub embodies: + +- **Professional** - Serious platform for competitive racing +- **Approachable** - Friendly and easy to use +- **Modern** - Contemporary design with clean aesthetics +- **Energetic** - Dynamic and responsive +- **Trustworthy** - Reliable and stable + +--- + +## Logo Usage Guidelines + +### Primary Logo + +The iRaceHub logo is the primary brand mark and should be used in most applications. + +**Usage:** + +- ✅ Use on white, black, and neutral backgrounds +- ✅ Maintain clear space around the logo (minimum 10% of logo width) +- ✅ Never rotate or skew the logo +- ✅ Never add effects, shadows, or gradients +- ✅ Ensure sufficient contrast with background + +**Don't:** + +- ❌ Change colors without approval +- ❌ Stretch or distort the logo +- ❌ Place on busy backgrounds that reduce visibility +- ❌ Use outdated versions +- ❌ Recreate the logo from scratch + +### Logo Variations + +- **Full Logo** - Logo with "iRaceHub" wordmark (preferred) +- **Icon Only** - Mark without text (for social media profiles, favicons) +- **Horizontal Layout** - Logo and text side-by-side +- **Vertical Layout** - Logo and text stacked +- **Monochrome** - Single color version for limited-color applications + +### Minimum Size + +- **Digital:** 200px width minimum +- **Print:** 1 inch width minimum + +### Clear Space + +Maintain a clear space equal to 10% of the logo's width on all sides. + +--- + +## Color Palette + +### Primary Colors + +| Color | Hex Value | RGB | Usage | +| ----------------- | --------- | --------------- | ------------------------------ | +| **Primary Black** | `#171717` | `23, 23, 23` | Primary text, primary elements | +| **Primary White** | `#ffffff` | `255, 255, 255` | Background, contrast | + +### Secondary Colors (Recommended) + +| Color | Hex Value | RGB | Usage | +| -------------- | --------- | --------------- | ------------------------ | +| **Racing Red** | `#DC2626` | `220, 38, 38` | Accent, CTAs, energy | +| **Sky Blue** | `#0EA5E9` | `14, 165, 233` | Secondary accent, trust | +| **Slate Gray** | `#64748B` | `100, 116, 139` | Supporting text, borders | + +### Dark Mode Support + +- **Dark Background:** `#0a0a0a` +- **Light Text (Dark Mode):** `#ededed` + +### Usage Guidelines + +- **Primary Colors:** Use black and white for main design elements +- **Secondary Colors:** Use sparingly for accents and calls-to-action +- **Consistency:** Maintain color consistency across all materials +- **Accessibility:** Ensure sufficient contrast for readability and accessibility + +--- + +## Typography + +### Font Families + +- **Primary Font:** Geist Sans (used throughout the application) +- **Fallback Stack:** Arial, Helvetica, sans-serif +- **Monospace (Code):** Geist Mono + +### Font Sizes (Web) + +| Size | Use Case | +| ----- | ------------------------ | +| 32px+ | Headlines, hero text | +| 24px | Section headers | +| 18px | Subheaders | +| 16px | Body text | +| 14px | Secondary text, captions | +| 12px | Small text, footnotes | + +### Font Weights + +- **Bold (700):** Headlines, emphasis +- **Semibold (600):** Subheaders, important labels +- **Regular (400):** Body text +- **Light (300):** Supporting text, backgrounds + +--- + +## Branding Guidelines + +### Do's ✅ + +- **Do** maintain professional tone in all communications +- **Do** use the official logo in its original form +- **Do** emphasize community and open-source aspects +- **Do** highlight specific features most relevant to your audience +- **Do** maintain consistent branding across all platforms +- **Do** credit iRaceHub when appropriate +- **Do** use current logos and brand assets (not outdated versions) +- **Do** ensure accessibility (contrast, alt text, etc.) + +### Don'ts ❌ + +- **Don't** alter or recreate the logo +- **Don't** use misleading claims about features +- **Don't** misrepresent iRaceHub as closed-source or paid +- **Don't** violate iRacing's own branding guidelines +- **Don't** use poor-quality or low-resolution assets +- **Don't** combine iRaceHub branding inappropriately with competitors +- **Don't** imply official endorsement without approval + +--- + +## Driver Promotional Materials + +### Elevator Pitch (15 seconds) + +> "iRaceHub is a free, open-source league management platform built by the iRacing community for the iRacing community. It handles schedules, results, standings, and virtual money—making league administration transparent and competitive racing more rewarding." + +### Short Description (30 seconds) + +> "iRaceHub brings modern league management to iRacing. League owners get powerful tools to manage series, sync schedules, import results, and manage virtual economies. Drivers get real-time standings, clear dashboards, and a transparent competitive environment. It's free, open-source, and built by racers for racers." + +### Quick Facts to Share + +- **Free to Use** - No licensing fees or subscriptions +- **Open Source** - View the code, contribute, or host it yourself +- **Community Built** - By iRacing drivers, for iRacing drivers +- **Full-Featured** - Schedules, results, standings, virtual money, widgets +- **Self-Hosted** - Your data stays in your control +- **Easy Setup** - Docker deployment makes hosting simple +- **Active Development** - Continuously improving based on community feedback + +--- + +## Social Media Guidelines + +### Platform-Specific Tips + +#### Twitter/X + +**Hashtags to Use:** + +- #iRaceHub +- #iRacing +- #SimRacing +- #LeagueManagement +- #OpenSource +- #Community + +**Tweet Examples:** + +- "Just switched our league to iRaceHub! The automatic schedule sync and instant results are game-changers. Plus, it's free and open-source! 🏁 #iRacing" +- "If you're running an iRacing league, you need to check out iRaceHub. Real-time standings, virtual money, and more—all free. #simracing" +- "Loving the transparency iRaceHub brings to our league. Every driver can see standings, payouts, and upcoming races in real-time. #community #iRacing" + +**Character Limits:** + +- Keep posts under 280 characters for maximum engagement +- Use thread format for detailed explanations + +#### Discord + +**Server Announcement Template:** + +``` +🏁 **Exciting News!** + +Our league is now using **iRaceHub** for league management! + +📊 View real-time standings and results +📅 See all upcoming races synced from iRacing +💰 Track virtual money and payouts +🎯 Everything in one easy-to-use dashboard + +Check it out at: [YOUR_RACEHUB_URL] + +#iRaceHub #iRacing #LeagueManagement +``` + +#### YouTube + +**Video Topics:** + +- "How iRaceHub Transformed Our League" +- "iRaceHub Tutorial: Getting Started" +- "i Racing League Management with iRaceHub" +- "Open Source Racing: iRaceHub Deep Dive" + +**Description Template:** + +``` +Learn about iRaceHub - the free, open-source league management platform for iRacing! + +⏰ Timestamps: +0:00 - What is iRaceHub? +[Your timestamps] + +📚 Learn More: +GitHub: https://github.com/DarrellRichards/iracehub +Website: [if available] + +✅ Subscribe for more iRacing content! +``` + +#### Twitch + +**Panel Text:** + +``` +iRaceHub League Manager +Check out our league standings and schedules powered by iRaceHub - +the free, open-source league management platform! +[Link to your iRaceHub instance] +``` + +--- + +## How to Promote in iRacing + +### In-Game Opportunities + +1. **Driver Center Profile** + - Add iRaceHub league info to your profile + - Example: "Competing in [League Name], managed with iRaceHub" + +2. **League Decals/Liveries** + - Create custom liveries featuring the iRaceHub logo + - Use your league URL as part of the design + - Share livery designs in community forums + +3. **Team Names & Paint Schemes** + - Incorporate "iRaceHub" into team names + - Feature the branding in your paint schemes + +### Community Forum Promotions + +1. **League Announcement Posts** + - Mention iRaceHub when advertising your league + - Share tangible benefits drivers experience + - Include links to standings or results pages + +2. **Forum Signature** + - Add a brief iRaceHub mention to your forum signature + - Example: "Running my league with iRaceHub - free, open-source league management" + +3. **Helpful Responses** + - When drivers ask about league management tools, recommend iRaceHub + - Provide genuine experiences and comparisons + - Be authentic and helpful, not spammy + +### VOD/Stream Promotion + +1. **Overlay Graphics** + - Include iRaceHub branding in stream overlays during league races + - Display live standings from iRaceHub + +2. **Race Commentary** + - Mention league features powered by iRaceHub during streams + - Highlight standings, payouts, or schedule information + - Share stories about how iRaceHub improved your league + +3. **Stream Title/Description** + ``` + iRacing League Race | Powered by iRaceHub | [Race Name] + ``` + +### External Website Promotion + +1. **League Website** + - Embed standings widget from iRaceHub + - Link to iRaceHub GitHub repo + - Add iRaceHub branding to footer + +2. **League Announcements** + - Feature iRaceHub in league newsletters + - Share tips for using iRaceHub features + - Highlight community feedback incorporated into updates + +3. **Blog/Articles** + - Write case studies about using iRaceHub + - Share how specific features improved your league + - Compare before/after experiences + +--- + +## Marketing Templates + +### Email Signature Template + +``` +--- +Racing with [League Name] on iRaceHub +Standings: [Your iRaceHub Link] +Check us out! Free, open-source league management. +``` + +### Discord Invite Banner Text + +``` +🏁 Welcome to [League Name] +Organized with iRaceHub - Free league management for iRacing +View standings: [Link] +``` + +### Twitch About Section + +``` +Competing in [League Name] with iRaceHub! 🏁 +Free, open-source league management for iRacing. +Standings: [Your iRaceHub Link] +``` + +### Website Button/Widget + +``` +HTML Snippet: + + Powered by iRaceHub + +``` + +### LinkedIn Post Template + +``` +🏁 Exciting Update: Our iRacing league now uses iRaceHub! + +We've switched to iRaceHub for league management and the improvement is incredible: + +✅ Automatic schedule syncing from iRacing +✅ Instant race result imports +✅ Real-time standing updates +✅ Virtual money management +✅ Transparent league operations + +And the best part? It's free and open-source, built by the community for the community. + +If you're running an iRacing league, you need to check this out! 🚀 + +#iRacing #SimRacing #LeagueManagement #OpenSource #Community +``` + +--- + +## Asset Resources + +### Official Repository + +**GitHub:** https://github.com/DarrellRichards/iracehub + +- Source code and documentation +- Latest logo files and brand assets +- Community contributions and issues + +### Approved Platforms for Branding + +- **Official GitHub** - Central hub for all assets +- **Community Forums** - iRacing forums and community sites +- **YouTube, Twitch, Discord** - Streaming and community platforms +- **League Websites** - Your league's official presence +- **Personal Streaming** - Your own streams and content + +### Brand Assets to Request + +If you need specific brand assets: + +1. Visit the GitHub repository +2. Check the `/public` directory for logos and images +3. Open an issue to request specific assets +4. The community can help provide what you need + +--- + +## Best Practices Summary + +### ✅ Do These Things + +| Practice | Why | +| --------------------------------------- | ----------------------------------------- | +| Share genuine experiences | Authenticity resonates with the community | +| Use official logos correctly | Maintains professional appearance | +| Highlight community/open-source aspects | This is iRaceHub's biggest selling point | +| Provide real links to resources | Helps drivers get started | +| Credit iRaceHub appropriately | Shows respect for the project | +| Keep branding consistent | Builds recognition and trust | + +### ❌ Avoid These Things + +| Problem | Impact | +| --------------------------- | ------------------------------------ | +| Misleading claims | Damages credibility and trust | +| Poor quality assets | Reflects poorly on the project | +| Spammy promotion | Gets ignored, hurts the community | +| Implied endorsements | Creates confusion and liability | +| Outdated information | Makes drivers think project is stale | +| Ignoring iRacing guidelines | Can result in content removal | + +--- + +## Getting Help & Contributing + +### Questions About Branding? + +1. **GitHub Issues** - Open an issue on the repository +2. **Community Forums** - Ask fellow community members +3. **Discord/Community Chat** - Real-time discussion (if available) + +### Want to Contribute? + +iRaceHub welcomes contributions: + +- **Code** - Submit pull requests with improvements +- **Documentation** - Help improve guides like this one +- **Branding** - Design new assets or materials +- **Marketing** - Create promotional content +- **Testing** - Report bugs and suggest features + +See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines. + +--- + +## License + +This branding guide is part of the iRaceHub project and is released under the [MIT License](LICENSE). + +You are free to use this guide and referenced branding assets to promote iRaceHub, provided you follow the guidelines outlined above. + +--- + +## Quick Reference Checklist + +Before sharing iRaceHub branding: + +- [ ] Using official logos/assets +- [ ] Maintaining consistent colors and typography +- [ ] Being accurate about features +- [ ] Following iRacing community guidelines +- [ ] Not implying false endorsements +- [ ] Crediting iRaceHub appropriately +- [ ] Using current information +- [ ] Ensuring content is accessible +- [ ] Avoiding misleading claims +- [ ] Providing accurate links/resources + +--- + +**Version:** 1.0 +**Last Updated:** May 2026 +**Maintained By:** iRaceHub Community + +--- + +_Help us grow! If you're promoting iRaceHub, let us know—we'd love to feature your work in the community._ diff --git a/DRIVER_PROMOTIONS_TOOLKIT.md b/DRIVER_PROMOTIONS_TOOLKIT.md new file mode 100644 index 0000000..1026584 --- /dev/null +++ b/DRIVER_PROMOTIONS_TOOLKIT.md @@ -0,0 +1,486 @@ +# iRaceHub Driver Promotions Toolkit + +Quick-reference promotional content and scripts for drivers promoting iRaceHub. + +--- + +## Social Media Ready-to-Use Posts + +### Twitter/X Posts + +#### Post 1: Feature Spotlight + +``` +🏁 Just discovered iRaceHub - game changer for our league! + +✅ Automatic schedule syncing +✅ Live standings & results +✅ Virtual money management +✅ Free & open source + +If you're in an iRacing league, your league owner needs to know about this. #iRacing #SimRacing +``` + +#### Post 2: Community Angle + +``` +There's something special about a league management tool built BY racers FOR racers. + +iRaceHub is exactly that - open source, free, and community-driven. + +No vendor lock-in. No surprise fees. Just solid league management. + +That's the iRacing community spirit right there. 🏁 #OpenSource +``` + +#### Post 3: Results Highlight + +``` +iRaceHub moment: Race results imported automatically. Live standings updated instantly. + +League owners can focus on racing. Drivers get transparency. + +This is what modern league management looks like. 👇 #iRacing +``` + +#### Post 4: Comparison + +``` +Before iRaceHub: Spreadsheets, manual updates, results confusion. +After iRaceHub: Real-time standings, automatic syncing, clear dashboards. + +If you've been managing a league the old way, you're doing it wrong. 😄 #SimRacing +``` + +#### Post 5: Call to Action + +``` +Running an iRacing league? Check out iRaceHub. + +It's: +✅ Free +✅ Open source +✅ Built for iRacing +✅ Actually works + +Your league, modernized. github.com/DarrellRichards/iracehub #iRacing +``` + +--- + +### Discord Messages + +#### Server Announcement + +``` +🏁 **Attention League Members!** 🏁 + +Our league now uses iRaceHub for all management needs! + +🎯 **What This Means For You:** +📊 Check real-time standings anytime +📅 View all races synced directly from iRacing +💰 See payouts and virtual money in real-time +🏆 Complete transparency on league operations + +📌 **Access Your League Dashboard:** [INSERT YOUR LINK] + +Questions? Ask admins or check the #league-info channel! + +#iRaceHub #iRacing #LeagueManagement +``` + +#### Casual Message + +``` +Shoutout to iRaceHub - made league management actually enjoyable. If you're running an iRacing league and you're not using it, you're missing out! 🏁 +``` + +#### Community Recommendation + +``` +Anyone here run or participate in an iRacing league? If so, check out iRaceHub. Free, open-source, and genuinely the best league management tool I've seen. Let me know what you think! +``` + +--- + +### Reddit Posts + +#### r/iRacing Post + +**Title:** "Our League Just Switched to iRaceHub - Best Decision Ever" + +**Body:** + +``` +We've been managing our iRacing league on Google Sheets and manual updates for too long. Finally made the switch to iRaceHub and it's been transformative. + +**What Changed:** +- Race results now sync automatically from iRacing +- Standings update in real time (literally seconds after races end) +- Drivers can see everything they need in one dashboard +- League ops are now transparent and automated + +**The Best Part:** +It's completely free and open-source. No subscription fees, no vendor lock-in, and it's built by the community for the community. + +If you're running an iRacing league and using spreadsheets, please check this out. Your drivers will thank you. + +GitHub: https://github.com/DarrellRichards/iracehub + +Anyone else using it? Would love to hear about your experience! +``` + +--- + +### YouTube Video Script (3-5 minute overview) + +``` +[INTRO - 0:00] +"Hey racers, today we're checking out iRaceHub - a free, open-source +league management platform for iRacing. If you either run or race in a +league, this tool needs to be on your radar." + +[WHAT IS IT - 0:30] +"iRaceHub is built specifically for iRacing communities. It handles +everything league owners need: schedules synced from iRacing, automatic +result imports, live standings, virtual money management, and more. +And here's the kicker - it's completely free and open-source." + +[WHY IT MATTERS - 1:00] +"Look, league management used to mean spreadsheets, manual updates, and +confusion. iRaceHub changes that. Everything's transparent, real-time, +and automatic. Drivers get instant standings. League ops get powerful +tools. Everyone benefits." + +[DEMO - 1:45] +"Let me show you what iRaceHub looks like in action. Here's a live +dashboard showing a league's standings. Notice how clean and intuitive +this is? Everything a driver needs to know is right here." + +[KEY FEATURES - 2:45] +"Let's break down what makes iRaceHub special: +1. Automatic schedule syncing from iRacing +2. Instant result imports after races +3. Real-time standings calculation +4. Virtual money and payout management +5. Public widgets for league websites +6. Complete transparency in operations +7. Self-hosted - your data, your server" + +[COMMUNITY ANGLE - 3:45] +"And this is what I love most - iRaceHub is built by iRacers for +iRacers. The GitHub repo is completely open. You can see the code, +contribute improvements, or host it yourself. This is community-driven +software at its best." + +[CLOSING - 4:30] +"If you're in an iRacing league, show your league owner this video. +If you run a league, check out the GitHub repo. iRaceHub is free, +reliable, and genuinely makes league management better." + +[OUTRO - 4:45] +"Thanks for watching. If you found this helpful, hit that subscribe +button. Link to iRaceHub is in the description. See you on the track!" +``` + +--- + +## Email Templates + +### To Your League's Driver Group + +**Subject:** Introducing iRaceHub - Your League Just Upgraded! 🏁 + +``` +Hey Team, + +We're excited to announce that [League Name] is now using iRaceHub +for all league management and communications. + +**What's iRaceHub?** +It's a professional league management platform designed specifically +for iRacing. All of your standings, race results, and league +information will be available in one place. + +**What This Means For You:** +✅ Real-time standings after every race +✅ Automatic race schedule in one place +✅ Instant results and points updates +✅ Complete transparency on league operations +✅ Access from any device, anytime + +**How to Get Started:** +1. Visit: [YOUR IRACEHU LEAGUE LINK] +2. Log in using your credentials +3. Check out your personal dashboard + +**Questions?** +Reach out to [League Admin Contact] + +We believe this will make our league experience even better. + +See you on the track! + +[League Admin] +``` + +### To Other League Owners + +**Subject:** You Should Know About iRaceHub + +``` +Hi [League Owner Name], + +I wanted to share something that's been working great for our league: +iRaceHub. + +It's a free, open-source league management platform built specifically +for iRacing communities. We've been using it for [timeframe] and it's +been fantastic for: + +- Automatic schedule syncing from iRacing +- Instant result imports +- Real-time standings +- Managing virtual money and payouts +- Transparent league operations + +The best part? It's completely free. No subscriptions, no vendor +lock-in. You own your data and can even host it yourself if you want. + +If you're looking to modernize how your league operates, I can't +recommend it enough. Check it out: + +GitHub: https://github.com/DarrellRichards/iracehub + +Happy to answer any questions about our experience with it. + +Best, +[Your Name] +[Your League Name] +``` + +--- + +## Twitch Overlay Integration + +### Panel HTML Snippet + +```html +
Powered by iRaceHub
+ + View Full Standings + ++ Free • Open Source • Community Built +
+