Skip to main content

Getting Started

Welcome to the Hoverkraft Docusaurus Theme! This is a strictly opinionated theme that enforces consistent Hoverkraft branding across all documentation projects.

Overview​

The Hoverkraft theme is designed with an opinionated philosophy that:

  • 🎨 Enforces Hoverkraft branding with fixed colors, typography, and layout
  • 📱 Provides responsive design that works on all device sizes
  • ⚡ Requires zero configuration - just install and use
  • 🧩 Includes standardized components with consistent styling
  • 🔧 Maintains brand consistency across all Hoverkraft projects

Opinionated Design Philosophy​

This theme intentionally removes customization options to ensure:

  • Brand Consistency: Every Hoverkraft documentation site looks professional and consistent
  • Reduced Complexity: No configuration means faster setup and fewer ways to break
  • Quality Standards: Enforced design patterns and accessibility best practices
  • Team Efficiency: Focus on content, not design decisions

What's Included​

Core Components​

  • Layout: Standardized page wrapper with Hoverkraft header and footer
  • Footer: Professional multi-section footer with company information
  • Logo: Fixed "Hoverkraft" text branding (no custom logos allowed)

Fixed Design System​

  • Official Branding: Colors, typography, and layout from the Hoverkraft Branding Guidelines - not customizable
  • Responsive Breakpoints: Mobile-first design approach
  • CSS Variables: Internal use only - not exposed for customization

For complete branding specifications including color values, typography scales, and design principles, refer to the Hoverkraft Branding Repository.

Development Features​

  • TypeScript Support: Full type definitions
  • Minimal Configuration: No theme-specific options required
  • Hot Reloading: Development-friendly setup
  • Standard Docusaurus: Full compatibility with all Docusaurus features

Next Steps​

  1. Install the theme in your Docusaurus project
  2. Start building - no configuration required!
  3. Explore the component documentation for reference

Live Demo​

This documentation site itself is built using the Hoverkraft theme, demonstrating the enforced branding and professional appearance!

Why Opinionated?​

By removing customization options, this theme ensures that:

  • All Hoverkraft documentation maintains a consistent professional appearance
  • Teams can focus on content creation rather than design decisions
  • Brand recognition is maintained across all Hoverkraft properties
  • Setup time is minimized - no complex configuration needed

The result is a cohesive ecosystem of documentation that looks and feels distinctly Hoverkraft.