Installation Overview

Choose the right installation method for your project - npm, CDN, or platform-specific packages.

Installation Overview

Turbo Themes is available through multiple distribution channels. Choose the one that best fits your project.

Quick Comparison

MethodBest ForSetup Time
npm/BunModern JavaScript projects2 min
CDNQuick prototypes, no build step1 min
Jekyll GemRuby/Jekyll sites2 min
PythonPython applications2 min
SwiftiOS/macOS apps3 min

What Gets Installed

Regardless of the installation method, you get access to:

  • Core CSS files - Token definitions and base styles
  • 9 theme files - All color schemes
  • Framework adapters - Bulma, Tailwind integrations
  • Syntax highlighting - Code block theming

File Structure

turbo-themes/
โ”œโ”€โ”€ css/
โ”‚   โ”œโ”€โ”€ turbo-core.css       # CSS variable definitions
โ”‚   โ”œโ”€โ”€ turbo-base.css       # Base semantic styles (optional)
โ”‚   โ”œโ”€โ”€ turbo-syntax.css     # Syntax highlighting (optional)
โ”‚   โ”œโ”€โ”€ themes/
โ”‚   โ”‚   โ””โ”€โ”€ turbo/
โ”‚   โ”‚       โ”œโ”€โ”€ catppuccin-mocha.css
โ”‚   โ”‚       โ”œโ”€โ”€ catppuccin-macchiato.css
โ”‚   โ”‚       โ”œโ”€โ”€ catppuccin-frappe.css
โ”‚   โ”‚       โ”œโ”€โ”€ catppuccin-latte.css
โ”‚   โ”‚       โ”œโ”€โ”€ dracula.css
โ”‚   โ”‚       โ”œโ”€โ”€ github-dark.css
โ”‚   โ”‚       โ”œโ”€โ”€ github-light.css
โ”‚   โ”‚       โ”œโ”€โ”€ bulma-dark.css
โ”‚   โ”‚       โ””โ”€โ”€ bulma-light.css
โ”‚   โ””โ”€โ”€ adapters/
โ”‚       โ””โ”€โ”€ bulma.css        # Bulma framework adapter

Minimum Requirements

For Web Projects

  • Any modern browser (Chrome, Firefox, Safari, Edge)
  • CSS custom properties support (all browsers since 2017)

For Development

  • Node.js 18+ (for npm installation)
  • Ruby 3.1+ (for Jekyll gem)
  • Python 3.9+ (for Python package)
  • Swift 5.9+ (for Swift package)

Next Steps

Choose your installation method: