Skip to content
dsiteinthPublic

About

Responsive FOSSBilling client area theme

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

twin - FOSSBilling Client Area Theme

twin theme preview

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.

Features

  • 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.

Installation

  1. Copy the entire twin folder into the themes/ directory of your FOSSBilling installation.
  2. Log in to the Admin Area.
  3. Navigate to the theme settings and select twin for the Client Area.

Theme Settings

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.

Customization

Admin Settings

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.

CSS

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.

Twig Overrides

For update-friendly template changes:

  1. Create html_custom/ in the theme root if it does not already exist.
  2. Copy only the template you need from html/ into html_custom/.
  3. 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.

Project Structure

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

Template Naming

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.

Development Notes

  • 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.js directly; it is a pre-built bundle.
  • Use FOSSBilling Twig helpers such as url, api_url, fb_api_form, and fb_api_link for routes and API actions.
  • Keep theme-setting Twig compatible with FOSSBilling's sandbox. Unsupported functions will prevent the settings page from rendering.
  • Review CHANGELOG.md for version history.

Support the Project

License

Released under the MIT License. Copyright (c) 2026 dsiteinth.

About

Responsive FOSSBilling client area theme

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages