Theme System

Larapen uses a theme system where each theme provides a complete visual identity for your site's front-end.

Installing a Theme

  1. Upload the theme folder to /extensions/themes/{theme-name}/
  2. Navigate to Appearance → Themes in the admin panel
  3. Click Activate on the theme you want to use
  4. Publish theme assets: php artisan theme:publish {theme-name}

Available Themes

  • Default: Clean, modern, professional. Wide layout with balanced whitespace.
  • Creative: Bold, asymmetric layouts for freelancers and agencies.
  • Elegant: Editorial-style with refined typography and magazine grid.
  • Minimalist: Clean, minimal design focused on content.
  • Technology: Dark-mode-first for developers and startups.

Customization

Themes use CSS custom properties for easy customization. Override theme colors and fonts by editing the :root variables in the theme's SCSS files, then rebuild with npx vite build.

Theme Overrides

Themes can override any view from core or add-ons by placing a matching file in the theme's views/ directory. The resolution order is:

  1. Theme views
  2. Add-on default views
  3. Core views

Was this article helpful?

Thank you for your feedback!

Still need help? Create a support ticket

Create a Ticket