webx-ui / theme-default

v0.79.0 2026-10-18 16:29 UTC

Requires

• php: ^8.4
• webx-ui/themes: ^0.79.0
• webx-ui/widgets: ^0.79.0

Requires (Dev)

• orchestra/testbench: ^11.0
• phpunit/phpunit: ^12.0 || ^13.0

MIT

• WebX UI

• theme
• laravel
• blade
• design-tokens
• webx-ui

Published on Packagist.org on 2026-10-18 16:33 UTC

README

The theme every new WebX UI site stands on.

It is not meant to be beautiful; it is meant to be a good place to start: a value for every site token, a neutral page shell and the typography of prose, in code that is easy to override. A new site gets its own theme/ on top of it and changes only what makes it different.

resources/views          ← the site itself
theme/                   ← the site's local theme: its differences
  → webx-ui/theme-default ← this package
    → modules            ← the look of their own pages

Part of WebX UI. The mechanism — the chain, the token vocabulary, @webxTheme — is webx-ui/themes.

Early days: this release holds the tokens, the layout with its header and footer, the shell and prose stylesheet, six block types, the icons, Inter in Latin, Latin Extended and Cyrillic, the 404 page, the frame of the letters and every word of the layout in ten languages.

What is in it

Path	What
tokens.json	a value for every token of the engine's vocabulary, and the presets warm and night
views/components/layout	the document: @webxTheme, the head, the header and footer regions, <main>
views/components/header	the header region's fallback: the site name and menu('header')
views/components/footer	the footer region's fallback: menu('footer') and the copyright line
views/mail/layout	the frame of every letter: values from theme_token() in style="…", no var()
src/css/	base.css, shell.css (site-* classes), prose.css (headings, lists, tables…)
dist/theme.css	the build of src/, committed: a site installs this theme with no Node
icons/	27 icons, 24×24 strokes in currentColor: <x-theme::icon name="phone" />
assets/img/	pictures of the theme: theme_asset('img/wave.svg')
assets/fonts/	Inter, a variable file per script and style; @webxTheme prints its @font-face
lang/<locale>/theme.php	the words of the layout in the ten locales: __('theme::theme.shell.skip')

Every rule is written on var(--site-…) tokens only and inside :where(), so it carries no specificity: a local theme, a module or a block overrides it by writing the rule at all.

Install

php artisan webx:setup is about to install it with every new site. Until then, by hand:

composer require webx-ui/theme-default
php artisan webx:theme:sync

and WEBX_THEME=webx-ui/theme-default (or a local theme/ that uses it) in .env.

Working on it

src/ is built into dist/ by Vite, and dist/ is committed. After an edit:

npx vite build

in this directory. dist/sources.json records what the build was made from, and the package's test fails when src/ and dist/ disagree.

License

MIT. The font in assets/fonts/ is Inter by The Inter Project Authors, under the SIL Open Font License 1.1 — assets/fonts/OFL.txt, which goes wherever the files go.