Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.nomos.energy/llms.txt

Use this file to discover all available pages before exploring further.

The hosted customer portal is the fastest path to giving your customers a working self-service experience. Nomos hosts it, themes it to your brand, and ships every new feature to your users automatically. Customers sign in with a one-time code emailed to them; you don’t have to run an identity system. If you want full control over the UI, see Build your own customer portal. If the hosted version covers what you need, you can stop reading at the end of this page; there’s nothing else to build.

​
What your customers get

Every section below is a real route in the hosted portal. There is no feature flag to enable any of it.
  • Dashboard. Today’s and tomorrow’s dynamic prices, current consumption, contract status, and the next bill at a glance.
  • Invoices. A paginated list of all invoices for the subscription. Each invoice opens to a detail view with a consumption breakdown and a downloadable PDF.
  • Consumption. Daily, weekly, and monthly meter data charted against price. Customers without a smart meter can submit a manual reading from the same screen.
  • Tariff overview. Working price, basic price, grid fees, contract dates, cancellation, and meter swap.
  • Account. Personal details, payment method (SEPA / IBAN), and the customer’s delivery and billing addresses. Personal details and payment method are editable; addresses currently render as read-only.
  • Product orders. Smart-meter rollout status and any add-on products the customer has ordered.
  • Help. A localized help center wired to your support channel.

​
Where it lives

Each plan you have configured on Nomos gets its own subdomain on customerportal.energy, derived from the plan’s slug: 
https://<plan-slug>.customerportal.energy
For example, a plan with slug acme-power is reachable at https://acme-power.customerportal.energy.

​
White-labeling

The portal is themed per plan and org, with no build step on your end. When a customer loads the portal, Nomos pulls:
  • Logo from orgs.logo, shown in the header and on the favicon.
  • Org name from orgs.name, used in the page title (e.g. Acme Kundenportal) and copy.
  • Colors from plans.colors, rendering the entire UI from primary, accent, and surface tokens.
  • Font from plans.fonts, loaded over the wire and applied via CSS variables.
Update any of these on the org or plan record and the portal reflects it on the next page load. There’s nothing to deploy.

​
How customers sign in

The default sign-in is a one-time code by email. The customer:
1

Visits the portal

Opens https://<plan-slug>.customerportal.energy/login.
2

Enters their email

Nomos checks the email against the customers on your plan and sends a six-digit code.
3

Enters the code

The code logs them in. The session persists; no password is involved.
If you’d rather drop an already-authenticated customer straight into the portal from your own app, use a magic link instead. See Magic Link for Customer Portal for that flow.