Skip to content

VectraLabel overview

VectraLabel is a food label compliance SaaS built on the TenancyEngine platform. It helps food businesses create, manage, and validate nutritional labels against FDA (USA) and CFIA (Canada) regulations.

What it does

  • Label CRUD — create and manage food labels with structured nutritional facts, serving sizes, and ingredient declarations
  • Compliance validation — instant per-field violation reporting against FDA 21 CFR and CFIA regulations; returns structured pass/fail results with remediation hints
  • Template management — save reusable label templates to accelerate label creation
  • Usage metering — per-tenant label creation metered via SaaSRuntime entitlements (labels.crud)

Architecture

VectraLabel is the first greenfield application on the TenancyEngine / SaaSRuntime / TenaBill stack:

ComponentRole
TenancyEngineTenant provisioning, OIDC identity (vectralabel client), entitlements
SaaSRuntimeOIDC token issuance, tenant context, usage meter
TenaBillBilling portal for end customers, merchant vectralabel
VectraLabel.ApiSingle deployable — ASP.NET Core 9 API + static SPA

Tenancy model

One tenant = one food business. All data (labels, templates) is scoped by TenantId. Demo tenant: demo-bakery.

Public surfaces (production)

SurfaceURL
Appapp.vectralabel.com
APIapi.vectralabel.com
Billing portalvia TenaBill on tenant-scoped hostname

Dev/staging uses *-dev.* hostnames — see Local development.

ProductDocs
TenancyEnginedocs.tenancyengine.com
TenaBilldocs.tenabill.com

VectraLabel documentation