twin is a responsive client-area theme for FOSSBilling. It uses server-rendered Twig templates, Bootstrap 5.3, vanilla CSS, and vanilla JavaScript. No frontend build step is required.
Compatibility: FOSSBilling 0.8.6 or newer.
- Responsive client dashboard with service, invoice, and support summaries.
- Desktop navigation and a mobile off-canvas menu generated from one shared menu template.
- Light and dark color modes with the visitor's preference stored in the browser.
- Configurable primary color, login options, breadcrumbs, dashboard showcase, sidebar links, footer links, and metadata.
- Responsive desktop tables and mobile list views for services, invoices, tickets, and emails.
- Service management pages, hosting control-panel login, domain management, checkout, and invoice views.
- FOSSBilling 0.8.6 cookie, currency, domain-period, Add Funds, profile-field, and authentication-flow compatibility.
- Local LINESeedSansTH fonts for Thai and Latin text.
- Inline SVG icons with no external icon-font dependency.
- Optional
html_custom/overrides that remain separate from the distributed templates.
- Copy the entire
twinfolder into thethemes/directory of your FOSSBilling installation. - Log in to the Admin Area.
- Navigate to the theme settings and select twin for the Client Area.
The Admin Area settings page includes:
- Appearance mode, primary brand color, and an optional Google Fonts family.
- Header and login-page visibility options.
- Breadcrumb and guest-dashboard behavior.
- Dashboard showcase content and action link.
- Individual sidebar navigation visibility controls.
- Optional sidebar note with Markdown content.
- Page title, description, robots, and other metadata.
- Footer visibility, signature, five configurable links, and custom JavaScript fields.
- Invoice subscription prompts and terms-policy behavior for checkout and signup.
Settings are managed by FOSSBilling presets. The files in config/ provide the settings form and bundled preset data; they are not a replacement for configuring the active preset in the Admin Area.
Open System > Settings > Themes, then click the gear icon for twin. This is the preferred way to change colors, visibility options, links, and page metadata.
Theme styles are in assets/css/twin.css. The main design values are CSS custom properties near the top of that file, including:
--twin-primary: #0e5077;
--twin-bg: color-mix(in srgb, var(--twin-primary) 3%, #ffffff);
--twin-radius: 5px;Do not edit assets/css/vendor.css; it contains pre-built vendor styles.
For update-friendly template changes:
- Create
html_custom/in the theme root if it does not already exist. - Copy only the template you need from
html/intohtml_custom/. - Keep the same filename and edit the copied file.
FOSSBilling prioritizes html_custom/ over html/. Both directories must remain flat: do not create template subdirectories.
twin/
|-- manifest.json # Theme metadata and version
|-- screenshot.png # Admin Area theme preview
|-- config/
| |-- settings.html.twig # Sandboxed Admin Area settings form
| |-- settings_data.json # Bundled theme preset data
| `-- settings_data.json.example
|-- html/ # Flat directory of Twig templates
|-- html_custom/ # Optional flat override directory
|-- fonts/LINESeedSansTH/ # Bundled Thai/Latin font files
`-- assets/
|-- css/
| |-- twin.css # Theme styles
| `-- vendor.css # Pre-built vendor styles; do not edit
`-- js/
|-- twin.js # Pre-built Bootstrap/Popper/TomSelect bundle
|-- fossbilling-compat.js # FOSSBilling compatibility bridge for the pre-built bundle
|-- utils.js # FOSSBilling message helper source
|-- tomselect.js # Locale selector initialization source
`-- avatar.js # Compatibility entry point
All Twig templates must be placed directly in html/ or html_custom/.
| Prefix | Purpose | Example |
|---|---|---|
layout_ |
Base page layouts | layout_default.html.twig |
mod_ |
Module and route templates | mod_order_list.html.twig |
partial_ |
Reusable template fragments | partial_menu.html.twig |
macro_ |
Shared Twig macros | macro_functions.html.twig |
| Other | Special-purpose templates | error.html.twig, mobile_menu.html.twig |
html/partial_menu.html.twig is the shared source for both desktop and mobile navigation.
- Do not introduce Tailwind CSS, React, Vue, npm, Webpack, or Vite. The theme is distributed as ready-to-use assets.
- Do not edit
assets/js/twin.jsdirectly; it is a pre-built bundle. - Use FOSSBilling Twig helpers such as
url,api_url,fb_api_form, andfb_api_linkfor routes and API actions. - Keep theme-setting Twig compatible with FOSSBilling's sandbox. Unsupported functions will prevent the settings page from rendering.
- Review
CHANGELOG.mdfor version history.
Released under the MIT License. Copyright (c) 2026 dsiteinth.
