Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

537 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Liberu Default

Neutral public and portal defaults built on Liberu Base.

Software · Hosting · Services · Liberu Group

PHP Latest release License: MIT

Visual scope

Neutral public and portal defaults built on Liberu Base. It is a presentation-only package: domain behaviour stays in modules and the host application retains control of theme selection and fallback.

A maintained preview image is not yet published. Add an optimised, accessible preview under .github/assets/ before claiming visual-regression coverage.

Requirements and installation

Dependency Supported version
php ^8.5
liberusoftware/theme-support ^1.0
liberusoftware/theme-base ^1.0

Install from the host project root:

composer require liberusoftware/theme-default

The trusted liberusoftware/composer-installer places the package in /themes/default. Composer and its lock file remain the source of version truth, and the installed theme directory is committed by the host.

Compatibility

  • Type: public
  • Parent: liberu-base
  • Optimised for: liberusoftware/boilerplate-laravel:^1.0
  • Tested with: liberusoftware/boilerplate-laravel:^1.0
  • Required capabilities: none
  • Optional capabilities: foundation.localization, foundation.theme-support
  • Supported surfaces: application.shell, identity.auth, foundation.account

Build and assets

Declared entry points:

  • resources/css/app.css
  • resources/js/app.js

Use the host's Vite build after installation:

npm install
npm run build

The theme supplies its own source assets and service provider. It does not bundle third-party fonts, images, icons, video, or templates; any such asset added later must include its licence and attribution.

Accessibility and fallback

Preserve keyboard access, visible focus, semantic landmarks, readable contrast, reduced-motion preferences, zoom/reflow, and system-font fallbacks. Hosts must retain a working base/default theme when optional assets or capabilities are unavailable.

Testing

Validate manifest parsing, provider registration, production asset compilation, supported host surfaces, responsive layouts, keyboard navigation, contrast, and fallback behaviour. Visual changes should include before/after evidence and should be checked at common viewport sizes.

Security

Do not report vulnerabilities through public issues. Email security@liberusoftware.com with reproduction details and the affected version.

License

This theme is open-source software under the MIT License. The linked licence text is authoritative.

Feedback and contributing

Focused issues and tested pull requests are welcome in the GitHub repository. Keep visual changes accessible, document asset provenance, and update CHANGELOG.md.

Contributors

Thank you to everyone who helps improve Liberu. View the contributors graph.

About

Neutral public and portal defaults built on Liberu Base.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages