Core concepts

The vocabulary that runs through Crubby: workspaces, restaurants, locations, franchisees, tenants, plans and roles.

A handful of nouns show up everywhere in Crubby. Learning them once makes the rest of the docs read quickly.

Workspace and restaurant#

Your workspace is anchored to a restaurant. The restaurant holds your menu, your screens, your media and your settings. When you log in, Crubby resolves your active restaurant from your session — typically your oldest active workspace. If you belong to several, switch between them from the profile menu (your avatar). See Signing in & access.

Locations (multi-sede)#

A restaurant can have several locations. One is the primary (home) location with full menu editing; secondary locations inherit the primary's catalogue and can layer on per-location overrides:

Price overrides — the same product at a different price per location.
Availability overrides — hide or show a product at a specific location.
Profile — each location has its own address, timezone, locale, currency, logo and accent colour.

Note

A secondary location that has zero categories of its own automatically inherits the primary's menu. Add a category to a secondary location and it stops inheriting.

Franchisee groups#

Locations can be organised into a group with a primary restaurant. Franchisees share a locked menu from the primary while keeping their own pricing and availability — the Locations page is where this is managed.

Tenant scoping#

Everything you create — menu, boards, media, activity — belongs to your restaurant (the *tenant*). Staff only ever see and edit their own restaurant's data, and media lives in a per-restaurant storage folder. Multi-location staff can manage across all the restaurants they belong to.

Plans, status and roles#

Plan — Free (the default trial after onboarding), or Crubby Sync (the paid Display plan). Manager is included with both. See Plans & limits.
Subscription status — active (writable), grace (payment lapsed, still writable), expired or cancelled (read-only — your screens keep playing). The status is set by Stripe's dunning, not a fixed Crubby timer.
Roles — Owner (full control incl. billing and team), Manager (edit everything, including destructive actions) and Waiter (day-to-day operations, no destructive actions). See Team & roles.

Boards, screens, walls and schedules#

Board: A designed menu layout (modules + style). Stored as draft + published versions.
Sequence: An ordered rotation of boards that plays one after another.
Group: A bundle of boards and/or sequences you can target together.
Screen / Monitor: A physical display paired to your fleet, showing a board, sequence or scheduled content.
Wall: Several screens arranged together and edited as one multi-monitor set.
Schedule rule: Decides what plays when — by daypart, date override, or emergency.