# BevWerk Documentation > Auto-generated documentation from Test-Driven Docs (TDDocs). > This file is optimized for LLM ingestion. --- # Account & billing Once the personal and company basics are set up, the next layer is the parts of BevWerk that belong to the *business*, not any one person: who can sign in, what point-of-sale system feeds your sales data, and what plan the company is on. ## Start here 1. [`Connect a POS integration`](/account/integrations/) — find where Clover and Square connections live, and what has to be true before you can start one. 2. [`Manage users`](/account/users-management/) — see the team table and the form for inviting a new teammate. 3. [`Understand your subscription`](/account/subscription/) — see what BevWerk shows you about your plan and billing status. ## Why this section matters These are owner/manager-level controls. They answer questions like: - where do I connect Clover or Square so sales show up in reports? - who currently has access to this company's BevWerk account, and how do I add someone? - what plan is this company on, and where do I see that? Getting these right early avoids confusion later — sales reports stay empty without a POS connection, and new hires can't get to work without a user account. --- # Connect a POS integration BevWerk does not have a standalone "Integrations" page. The connection points live one level deeper, inside company setup, because a POS integration is really a property of a *location*, not the app as a whole. ## Where this lives Go to **Settings → Company Info**. Two things matter on this page: - A **POS** row under Basic Info shows whether Clover and Square are available to this company at all. - The **Locations** table lists every location, and each row has a kebab (⋮) menu with the actual connect actions — **Integrate Clover** and **Integrate Square** — when that location isn't connected yet. ## What gates the connect actions The Clover/Square actions in a location's kebab menu only appear once POS is enabled for the company. That's a plan-level entitlement: the POS toggles on the Basic Info panel are disabled until the company is on an active/pro subscription. So if you don't see "Integrate Clover" or "Integrate Square" on a location, check [`your subscription status`](/account/subscription/) first — that's usually why. Once POS is enabled, a connected location shows the relevant POS icon (with a tooltip naming the integration) in the table's Integrations column, and the kebab menu switches from "Integrate" to "Remove" for that POS. ## Watch the walkthrough - [Open the integrations walkthrough](/tutorials/integrations-spec-integrations-walkthrough/) The walkthrough stops at the kebab menu — actually connecting Clover or Square hands off to that provider's own sign-in page, which isn't part of this app. ## What to do next - Continue to [`Manage users`](/account/users-management/) - Or revisit [`Understand your subscription`](/account/subscription/) if POS isn't showing up yet --- # Understand your subscription Subscription status isn't just a billing detail in BevWerk — it's also what unlocks features like POS integrations (see [`Connect a POS integration`](/account/integrations/)). ## Where this lives Open the user menu, then **Company → Subscription**. The same view is also reachable from the **Subscription** button inside Settings → Company Info. ## What you'll see Most accounts see a billing summary with the recurring price, the number of active locations the plan covers, and an action button for managing the plan. Some accounts — internal demo and friends-of-BevWerk accounts — see a "You are a Super Friend!" message instead of the billing summary. There's no inconsistency here: those accounts are intentionally exempted from the billing UI, so this is the expected, fully-supported state for them rather than a missing feature. ## Watch the walkthrough - [Open the subscription walkthrough](/tutorials/subscription-spec-subscription-walkthrough/) The walkthrough shows whichever of those two states the demo account is actually in — it doesn't assume one over the other, since which one you see depends on the account. ## What to do next - Revisit [`Connect a POS integration`](/account/integrations/) — POS connections depend on plan status - Or go back to [`Manage users`](/account/users-management/) --- # Manage users Every BevWerk company needs more than one set of hands. The Users workspace is where managers see who already has access and bring on someone new. ## Where this lives Open the user menu in the top-right of the toolbar, then **Company → Users**. This opens an overlay with two views: - A **table** of existing users, with name, location, and role, plus search and a "Hide Deactivated" option. - An **add** form, reached via the **Add User** button (managers only), for inviting a new teammate with a role, basic info, and login details. ## Why two views Keeping the table and the form as separate tabs in the same overlay keeps "who's already here" and "bring someone new on" from competing for space — useful when a manager is mid-task adding one person but wants to double check an existing teammate's role first. ## Watch the walkthrough - [Open the users management walkthrough](/tutorials/users-management-spec-users-management-walkthrough/) The walkthrough opens the Add User form and shows its fields, but stops short of submitting — no real account gets created. ## What to do next - Continue to [`Understand your subscription`](/account/subscription/) - Or go back to [`Connect a POS integration`](/account/integrations/) --- # Catalog setup Before inventory, taps, or menus mean anything, BevWerk needs to know about the things you sell and who you get them from. That reference data lives in the gear-icon Tools menu, separate from the personal and company settings covered in [`Account & billing`](/account/). ## Start here - [`Manage your catalog`](/catalog/manage-catalog/) — Distributors, Producers, Products, and Styles, plus the built-in Import catalogs for Producers and Styles. ## Why this section matters These four areas are catalog entities: they describe your business's supply side, and most other workflows (inventory, taps, menus) reference them rather than duplicating the same information. Two of them — Producers and Styles — also offer a faster path than typing everything by hand: an **Import** option that pulls from BevWerk's built-in reference catalog instead of a blank form. --- # Manage your catalog All four of these live behind the gear icon in the toolbar (Tools menu), not the avatar menu — that's reserved for personal and company-wide settings. Each one opens the same way: a table of existing records, and an "Add" form reached from a button next to the title. ## Distributors Who you buy from. A Distributor record is mostly contact info — name, rep, phone, email — used elsewhere to associate purchases with a source. ## Producers and Products **Producers** are who makes what you sell — breweries, wineries, distilleries. **Products** are the specific items: a particular beer, wine, or spirit, tied back to a Producer and a Style. Setting up Producers before Products keeps Product entry from turning into free-text guessing about who made something. ## Styles The style taxonomy products are categorized under (think: "IPA," "Pilsner," "Stout"). Products reference a Style, which is what powers style-based filtering and reporting elsewhere in BevWerk. ## The Import catalogs Producers and Styles both have an **Import** icon button next to their title (look for the tooltip — the icon itself isn't labeled). This isn't a CSV uploader. It opens a filter panel over BevWerk's own built-in reference catalog: - **Producers**: filter by **State** and **Country**, then **Import Selected** to bulk-add producers from that region instead of typing each one in by hand. - **Styles**: filter by **Type**, then **Import Selected** to bulk-add from BevWerk's built-in style list. This is the fastest way to seed either list — worth knowing about before manually typing in producers or styles one at a time. ## Watch the walkthrough - [Open the catalog entities walkthrough](/tutorials/catalog-entities-spec-catalog-entities-walkthrough/) The walkthrough opens each area's table and add form, and opens both Import catalogs, but stops before importing or saving anything — no real catalog data gets created. ## What to do next - Continue to [`Manage operational settings`](/operations/manage-operations/) - Or revisit [`Account & billing`](/account/) for the company-level settings this section assumes are already in place --- # Dashboard & navigation The dashboard is where BevWerk teaches the shape of the workspace before you have a polished setup. ## Start here 1. [`Understand your dashboard`](/dashboard/understand-your-dashboard/) — read the blank-slate guidance, side navigation, and next-best-action cues like an owner or manager. 2. [`Open the direct dashboard walkthrough`](/tutorials/homepage-dashboard-spec-understand-your-dashboard/) — jump straight to the recorded version when you want the proof layer without extra narration. ## What this section is for This section is deliberately **reference-first**. It exists to explain: - what the home screen is trying to tell you - how the side navigation maps the product - which empty states are useful guidance rather than errors - how the dashboard connects directly to inventory and publishing workflows ## Where this fits in the larger docs set - Start with [`Your first day in BevWerk`](/getting-started/first-day/) if you want the story-led version. - Come here when you want the dashboard explained plainly, without the rest of the onboarding arc around it. --- # Understand your dashboard This guide is for the moment you land in BevWerk and want to know what the home screen is actually telling you. ## What you'll learn By the end of this guide, you will know: - how BevWerk uses the dashboard to orient a brand-new workspace - why the side navigation matters even before you have inventory data - what the taplist prompt is trying to teach you - how dashboard cues connect directly to inventory and menu publishing ## What the dashboard is doing for you On day one, the dashboard is not trying to impress you with charts. It is trying to reduce ambiguity. That means it focuses on three useful jobs: 1. **showing the product map** through the left navigation 2. **pointing to the next meaningful action** when your workspace is still empty 3. **teaching the relationship** between taplists, inventory, and guest-facing menus ## Watch the walkthrough - [Open the direct dashboard walkthrough](/tutorials/homepage-dashboard-spec-understand-your-dashboard/) If you want the broader onboarding arc around it, the story-led version still lives in [`Your first day in BevWerk`](/getting-started/first-day/). ## How to read the blank-state guidance Blank space on the dashboard is not failure. In BevWerk, it usually means one of two things: - you have not set up the operational structure yet - the app is showing you the prerequisite for the next workspace you open That is especially important around **taplists**. BevWerk uses them as the connective layer between what you stock and what you publish. ## Why the side navigation matters so early Even before you add data, the side navigation tells you how the product is organized: - **Dashboard** gives you orientation and next-step context - **Beverages** is where inventory structure lives - **Menus** is where that structure becomes guest-facing output - **Settings** and **Help** support the personal and operational edges of the workflow That makes the dashboard less of a destination and more of a launchpad. ## What to do next - Continue to [`Manage inventory with confidence`](/inventory/manage-inventory/) - Then move on to [`Publish your menu`](/publishing/publish-your-menu/) - Or go back to the story-led version in [`Your first day in BevWerk`](/getting-started/first-day/) --- # Start here If you're opening BevWerk for the first time, start with the same sequence a new owner or manager sees in a brand-new workspace. ## The recommended path 1. [`Your first day in BevWerk`](/getting-started/first-day/) — understand the dashboard, blank-slate guidance, and the first setup task. 2. [`Manage inventory with confidence`](/inventory/manage-inventory/) — see how BevWerk separates kegs, bottles and cans, and on-tap readiness. 3. [`Publish your menu`](/publishing/publish-your-menu/) — understand how taplists unlock digital, paper, and bar menu experiences. ## Why this sequence works - **The dashboard** shows the first-run prompts and next best action. - **Inventory screens** explain how BevWerk organizes the work behind your beverage program. - **Menu screens** show the payoff: the same taplist data powers what your guests eventually see. If you prefer the raw recorded walkthroughs, jump straight to [`Tutorials`](/tutorials/). --- # Your first day in BevWerk This guide is designed for **owners and managers** who are starting from a fresh BevWerk workspace. ## What you'll accomplish By the end of this guide, you will know: - what the dashboard is trying to tell you on day one - where BevWerk keeps beverage inventory work - why **creating a taplist** is the first key setup task - how menu publishing builds on that taplist foundation ## What to expect on a new account A brand-new workspace is intentionally quiet. BevWerk doesn't pretend you already have a polished menu and fully stocked inventory. Instead, it points you toward the next meaningful action: - review the dashboard guidance - create your first taplist - start organizing inventory against that operational structure That makes the onboarding experience honest and actionable. ## Watch the walkthrough - [Open the recorded first-day walkthrough](/tutorials/getting-started-spec-getting-started-with-bevwerk/) ## Why the taplist matters so early In BevWerk, the taplist is more than a display choice. It is the connective tissue between: - **what you stock** - **what is on tap** - **what appears on guest-facing menus** Once you understand that, the rest of the app feels much more intuitive. ## What to do next - Continue to [`Manage inventory with confidence`](/inventory/manage-inventory/) - Then move on to [`Publish your menu`](/publishing/publish-your-menu/) --- # BevWerk Documentation ## Start with the manager path If you are new to BevWerk, follow this sequence first: 1. [`Your first day in BevWerk`](/getting-started/first-day/) — understand the dashboard and the first meaningful setup cue. 2. [`Manage inventory with confidence`](/inventory/manage-inventory/) — see how BevWerk organizes kegs, packaged inventory, and on-tap readiness. 3. [`Publish your menu`](/publishing/publish-your-menu/) — learn how taplists power digital, paper, and bar menu experiences. ## Keep exploring with more stories Once the first-run flow makes sense, continue with stories that help people operate BevWerk day to day: - [`Find answers fast`](/support/find-answers-fast/) — learn how BevWerk organizes FAQs and support guidance for quick self-serve answers. - [`Make BevWerk feel like home`](/settings/make-it-yours/) — review profile details, photo management, and password updates. ## Reference docs live alongside stories Not every page needs to be a narrative arc. As this site grows, we will also keep **generic task docs** and **error/troubleshooting pages** in their own reference-oriented sections rather than forcing them into story guides. That work has already started in [`Troubleshooting`](/support/troubleshooting/), where missing-page and sign-in recovery guides live separately from the story-led onboarding path, and in [`Dashboard & navigation`](/dashboard/), where the home screen and app wayfinding can be explained directly instead of awkwardly jammed into a story beat. ## How these docs work This site blends two layers: - **Editorial guides** explain the why, the sequence, and the business outcome. - **Generated tutorials** prove the flow with real Playwright recordings and step-by-step clips. Every walkthrough is: 1. **Captured** — A real browser workflow is recorded. 2. **Verified** — Playwright replays it in cinematic mode. 3. **Published** — videos are sliced, markdown is generated, and the docs site updates. ## For AI Agents This site exposes an [`/llms.txt`](/llms.txt) endpoint — a plain-text version of all documentation, optimized for LLM ingestion and RAG pipelines. --- # Inventory Inventory in BevWerk is organized around the questions managers actually need to answer, not around one giant all-purpose screen. ## Start here 1. [`Manage inventory with confidence`](/inventory/manage-inventory/) — understand how kegs, bottles and cans, and on-tap views each serve a different operational purpose. ## What you'll find in this section - guidance for draft inventory and keg workflows - packaged inventory context for bottles and cans - on-tap readiness cues tied to taplist setup - the connection between inventory structure and menu publishing ## Why this section matters Inventory is where BevWerk stops being abstract. Once this section makes sense, the rest of the product becomes easier to trust because you can see where beverage data lives, how it is searched, and what setup is still missing. --- # Manage inventory with confidence Inventory confidence does not come from one giant screen. BevWerk separates the work into views that answer different questions. ## The three views that matter first ### Kegs Use the kegs workspace when you want to understand your draft inventory structure, search what you have, and start building inventory records. ### Bottles & Cans Use this view to manage packaged inventory separately from draft. It keeps packaged stock from getting buried under keg-centric workflows. ### On Tap This view is operational rather than purely inventory-oriented. It tells you whether your active taplists are ready to support what you want to serve. ## Watch the walkthrough - [Open the inventory confidence walkthrough](/tutorials/inventory-confidence-spec-inventory-confidence-walkthrough/) ## What this story teaches Even in a blank workspace, the product makes its structure clear: - **tables** show where inventory will live - **search** shows how managers will quickly find items later - **empty states** tell you what prerequisite is missing - **taplist messaging** explains why on-tap workflows depend on setup, not guesswork ## What to do next When the inventory structure makes sense, move to [`Publish your menu`](/publishing/publish-your-menu/) to see how that internal work becomes guest-facing output. --- # Operational settings Once your catalog (see [`Catalog setup`](/catalog/)) describes what you sell, this section covers how it gets served day to day: what glass it's poured in, what taplist it's on, what flight it's grouped into, and what menu category it shows up under. ## Start here - [`Manage operational settings`](/operations/manage-operations/) — Flights, Glassware, Menu Categories, and Taps & Taplists. ## Why this section matters These areas are simpler than the catalog entities — none of them have an Import catalog — but they're what a manager touches most often once the catalog is in place, especially Taps, which is also where taplists themselves get created. --- # Manage operational settings Like the catalog entities, these four live behind the gear icon in the toolbar (Tools menu). Three of them follow the same table-plus-add-form shape; Taps is built differently because it's managing two related things at once — taplists and the taps on them. ## Flights A Flight groups several pours together (a tasting flight). Adding one asks for a name, the glassware it's served in, and a price. ## Glassware The physical vessels — name, size, unit, and pour price. Flights and Products both reference glassware, so this is worth setting up early. ## Menu Categories How items are grouped on menus. Unlike the others, this list has no search box — it's a short, drag-to-reorder list (categories are usually few enough to scan directly), with a kebab menu per row for editing or deactivating. ## Taps & Taplists This is the management side of what you see operationally on the [`On Tap`](/inventory/manage-inventory/) dashboard view. A location can have multiple taplists, each with its own set of taps; an **Add Taplist** button is always available from this screen, even before any taplist exists yet. Once you're inside a taplist, an **Add Tap** action appears if that taplist doesn't have any taps assigned. ## Watch the walkthrough - [Open the operational settings walkthrough](/tutorials/operational-settings-spec-operational-settings-walkthrough/) The walkthrough opens each area's table and add form — including whichever taplist state your account is actually in — and stops before saving anything new. ## What to do next - Revisit [`Manage your catalog`](/catalog/manage-catalog/) if Flights or Products reference something that doesn't exist yet - Or go back to [`Operational settings`](/operations/) --- # Menus & publishing Publishing is where BevWerk turns internal setup into something guests and staff can actually use. ## Start here 1. [`Publish your menu`](/publishing/publish-your-menu/) — learn why BevWerk treats taplists as the prerequisite for digital, paper, and bar menu workflows. ## What this section covers - digital menu starting points - paper menu readiness - bar menu publishing surfaces - the relationship between taplists and guest-facing output ## Why this section matters It is easy to think of publishing as cosmetic work. In BevWerk, it is actually the payoff for the structure you created elsewhere. That is why this section belongs right after onboarding and inventory in the recommended docs path. --- # Publish your menu Publishing is the moment your internal beverage work becomes visible to guests and staff. BevWerk makes that relationship explicit: no taplist, no finished menu surface. ## What this guide focuses on This is not a design tutorial yet. It is the manager view of publishing readiness. You will see how BevWerk uses taplists as the prerequisite for: - **Digital Menu** displays - **Paper Menu** output - **Bar Menu** publishing surfaces ## Watch the walkthrough - [Open the publish-your-menu walkthrough](/tutorials/publish-your-menu-spec-publish-your-menu-walkthrough/) ## Why the empty state is useful The empty-state message is not a dead end. It explains the production rule of the system: > publishing starts with a taplist That is a great first-run teaching moment because it ties menu output directly back to the operational setup you control. ## Suggested next move inside the app Start by creating your first taplist, then return to the menu workspaces to preview how BevWerk can power your guest-facing menu channels. ## Keep exploring - Revisit [`Your first day in BevWerk`](/getting-started/first-day/) - Revisit [`Manage inventory with confidence`](/inventory/manage-inventory/) - Browse all [`Tutorials`](/tutorials/) --- # Reports Reports is where BevWerk surfaces sales reporting for locations with a connected Clover or Square integration. ## Start here 1. [`Understand sales reports`](/reports/sales-reports/) — see what the Reports workspace shows and why the first-run state depends on POS setup. ## What you'll find in this section - where sales reporting lives in the app - what changes when a location has Clover or Square connected - why a location without a POS integration sees a setup message instead of report tables ## Why this section matters Reports are intentionally tied to POS data. If the active location has no Clover or Square integration, BevWerk does not pretend sales reporting is available. That makes the Reports screen useful both as a reporting surface and as a clear setup checkpoint. --- # Understand sales reports The Reports section currently opens to **Sales**. ## What you see first Open Reports from the app navigation, or go directly to `/reports/sales`. The Sales page always starts with the same purpose: showing sales reporting for the active location. What appears next depends on whether that location has a POS integration. ## If Clover or Square is connected BevWerk shows two tabs: - **Orders** — sales grouped around order-level reporting - **Items** — sales item reporting with product, vessel, price, quantity, and style context Both reports include date-range controls so managers can narrow the time period they are reviewing. ## If no POS integration is connected BevWerk shows this message: > Sales reports require a Clover or Square integration on the active location. That is the expected first-run state for a location that has not connected POS sales data yet. The Reports page is still useful because it tells managers exactly why report tables are not available. ## Watch the walkthrough - [Open the Reports walkthrough](/tutorials/reports-spec-reports-walkthrough/) ## What to do next If the no-integration message appears, connect Clover or Square for the active location before expecting sales tables to populate. If report tabs are already visible, start with **Orders** for order-level review and switch to **Items** when you need product-level sales detail. --- # Profile & settings Once the product structure makes sense, the next layer is personal setup: making sure your account details, profile information, and password hygiene are in good shape. ## Start here 1. [`Make BevWerk feel like home`](/settings/make-it-yours/) — review the profile, photo, and password surfaces managers are likely to touch first. 2. [`Review company info`](/settings/review-company-info/) — understand how BevWerk organizes company details, locations, and subscription context. ## Why this section matters These are not headline features, but they absolutely shape trust. A product feels production-ready when people can quickly answer questions like: - is my account information correct? - where do I update my password? - where does my profile photo live? - what settings are personal versus operational? - where do company details, locations, and subscription information live? That is the kind of clarity this section is for. --- # Make BevWerk feel like home This guide is for the moment after first-run orientation, when a manager wants the app to feel like *their* workspace rather than a demo account. ## What you'll learn By the end of this guide, you will know: - where your core profile details live - what information BevWerk keeps on hand for your account - where profile photos are managed - where password updates happen ## Why this story matters Account settings are quiet features, but they are trust-building features. When profile and password controls are easy to find, people feel more confident that the product is ready for everyday use. ## Watch the walkthrough - [Open the make-it-yours walkthrough](/tutorials/make-it-yours-spec-make-bevwerk-feel-like-home/) ## What this story teaches This walkthrough shows that BevWerk separates: - **personal identity** information - **profile presentation** details like photos - **security actions** like password changes That separation helps managers understand what belongs to them personally versus what belongs to the shared business setup. ## What to do next - Visit [`Help & support`](/support/) - Revisit [`Your first day in BevWerk`](/getting-started/first-day/) --- # Review company info This guide is for the operational side of settings: the information that belongs to the business, not just the individual user. ## What you'll learn By the end of this guide, you will know: - where BevWerk keeps company information for the workspace - how locations are introduced into the system - where subscription context lives - how to distinguish shared business settings from personal profile settings ## Why this matters Settings feel much clearer when BevWerk separates **your account** from **the business account**. That keeps everyday administration more predictable for owners and managers who need to understand what belongs to them personally versus what belongs to the whole operation. ## Watch the walkthrough - [Open the company info walkthrough](/tutorials/company-info-spec-review-company-info/) ## What this guide proves The company info area gives managers three useful anchors: - a place for shared business details - a clear entry point for adding locations - subscription context that explains the current account state without making you hunt for it ## What to do next - Return to [`Profile & settings`](/settings/) - Continue with [`Make BevWerk feel like home`](/settings/make-it-yours/) - Or move into [`Website & events`](/website/) if you are preparing public-facing content --- # Help & support When you need an answer quickly, BevWerk should help you solve the problem before you need to open a support chat. ## Start here 1. [`Find answers fast`](/support/find-answers-fast/) — learn where BevWerk already explains common questions. 2. [`Troubleshooting`](/support/troubleshooting/) — jump straight to tested recovery guides for missing pages and sign-in issues. ## What belongs in this section This section will deliberately mix **story guides** with **reference-style troubleshooting docs**: - story-driven help journeys for common operator questions - quick-answer references for recurring tasks - troubleshooting and error docs, including missing pages, sign-in recovery, and future edge-case guides Stories explain the normal flow. Troubleshooting pages explain exceptions without forcing them into a fake narrative. --- # Find answers fast This guide is for operators who want answers quickly without breaking their workflow. ## What you'll learn By the end of this guide, you will know: - where BevWerk keeps its FAQ library - how help topics are grouped across the product - where to look before opening a support conversation - how BevWerk points you toward the right operational answer ## Why this story matters Good help docs should reduce friction, not create another scavenger hunt. This walkthrough shows that BevWerk already organizes common questions into a structure that feels familiar to managers: - dashboard questions stay with dashboard work - beverage questions stay with beverage work - menu questions stay with publishing work - support guidance stays easy to find when you need a human ## Watch the walkthrough - [Open the find-answers-fast walkthrough](/tutorials/find-answers-fast-spec-find-answers-fast/) ## What this story proves A strong help experience does two jobs at once: 1. it answers the immediate question 2. it teaches you where to look next time That second part is what makes support feel scalable instead of reactive. ## What to do next - Continue to [`Make BevWerk feel like home`](/settings/make-it-yours/) - Return to [`Publish your menu`](/publishing/publish-your-menu/) --- # Troubleshooting Troubleshooting pages are intentionally **reference-first**. They are here to answer one question quickly: *what do I do next when something unexpected happens?* ## Start with these recovery guides 1. [`Recover from a missing page`](/support/troubleshooting/missing-pages/) — see how BevWerk handles stale or mistyped links. 2. [`Fix common sign-in problems`](/support/troubleshooting/sign-in-problems/) — review the built-in cues for email validation, failed logins, and password recovery. ## Why this section exists Stories are great for normal workflows. Troubleshooting docs are better when they stay direct: - what happened - what BevWerk shows you - what action to take next That keeps recovery guidance fast, calm, and practical. --- # Recover from a missing page This guide is for the moment a bookmark, shared link, or typed URL sends you somewhere that no longer exists. ## What you'll learn By the end of this guide, you will know: - how BevWerk signals that a page is missing - what message the app shows instead of failing silently - how to recover and return to the main workspace quickly ## Why this matters Broken links happen. What matters more is whether the product helps you recover without panic. This walkthrough shows that BevWerk keeps the normal workspace frame visible, explains what happened in plain language, and lets you get back to work without guessing. ## Watch the walkthrough - [Open the missing-page walkthrough](/tutorials/missing-page-spec-recover-from-a-missing-page/) ## What this proves When a page is gone, BevWerk does three useful things: 1. it tells you the page was moved or no longer exists 2. it keeps the app shell available so you are not stranded 3. it makes recovery immediate instead of forcing a dead end ## What to do next - Return to [`Help & support`](/support/) - Continue with [`Find answers fast`](/support/find-answers-fast/) --- # Fix common sign-in problems This guide is for the first few minutes of login friction, when you want to know whether the problem is formatting, credentials, or a password reset situation. ## What you'll learn By the end of this guide, you will know: - how BevWerk flags an invalid email format before you submit - what message appears after an unsuccessful login attempt - where the password reset flow starts ## Why this matters Sign-in problems are stressful when the product stays vague. This walkthrough shows the opposite approach: BevWerk gives operators a clear validation cue, a friendly failed-login message, and an obvious reset path without making them hunt for help. ## Watch the walkthrough - [Open the sign-in troubleshooting walkthrough](/tutorials/sign-in-problems-spec-troubleshoot-sign-in-problems/) ## What this proves The sign-in experience is doing more than authenticating a user. It is also coaching recovery by separating: - formatting mistakes you can fix immediately - credential errors that need another attempt - access problems that should move straight into password reset ## What to do next - Visit [`Troubleshooting`](/support/troubleshooting/) - Return to [`Your first day in BevWerk`](/getting-started/first-day/) --- # Tutorials # Tutorials This section is populated by the TDDocs pipeline. ## Available walkthroughs ## Regenerate tutorials Run the docs generation pipeline to create tutorial pages from the Playwright specs in `tools/docs/specs/`. ```bash npx nx run docs:generate ``` If your local docs database is already prepared and you only want to regenerate the docs artifacts, use: ```bash npx nx run docs:generate:no-reset ``` After generation completes, refresh the docs site. If new tutorial routes still do not appear locally, restart the docs dev server: ```bash npx nx run docs:dev ``` --- # Navigate The Dashboard Sidebar And Settings Menu > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk dashboard 2. Read the sidebar like a product map 3. Open the Kegs workspace from the sidebar 4. Open the gear menu to see the management tools 5. Open the Producers workspace from the gear menu 6. Switch to the Products workspace from the gear menu --- # Catalog Entities Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk dashboard 2. Manage Distributors 3. Manage Producers, including the Import Producers catalog 4. Manage Products 5. Manage Styles, including the Import Styles catalog --- # Review Company Info > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk dashboard 2. Open the company information workspace 3. Review the subscription details BevWerk keeps on hand --- # Demo Feature Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Navigate to the application 2. Verify the page content 3. Check the More Information link --- # Digital Menu Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk dashboard 2. Open the Digital Menu workspace 3. Review the current digital menu state --- # Find Answers Fast > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk workspace 2. Open the FAQ library 3. Scan the help topics BevWerk organizes for you 4. Open the support FAQ when you need a human 5. Learn how to project a Digital Menu to a display --- # Getting Started With BevWerk > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Orient yourself on the dashboard 2. See how On Tap reflects your current setup 3. See how menu publishing reflects that same setup --- # Understand Your Dashboard > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start at the homepage and get redirected to sign in 2. Sign in and arrive on the dashboard 3. Use the dashboard navigation to re center yourself --- # Integrations Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk dashboard 2. Review the POS entitlement in Company Info 3. Open the Locations table and inspect the row actions --- # Inventory Confidence Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk dashboard 2. Review the Kegs inventory table 3. Check the Bottles and Cans inventory view 4. See how the On Tap workspace reflects your setup --- # Login Feature Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Navigate to the login page 2. Enter credentials and submit --- # Make BevWerk Feel Like Home > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk workspace 2. Open your profile settings 3. Review the details BevWerk keeps on hand 4. See where profile photos and password updates live --- # Recover From A Missing Page > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from the dashboard so the workspace navigation is available 2. Open a link that no longer exists 3. Read the recovery message BevWerk shows 4. Return to the dashboard and keep working --- # Operational Settings Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk dashboard 2. Manage Flights 3. Manage Glassware 4. Manage Menu Categories 5. Manage Taps and Taplists --- # Paper Menu Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk dashboard 2. Open the Paper Menu workspace 3. Review the current paper menu state --- # Publish Your Menu Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk dashboard 2. Open the Digital Menu workspace 3. Review the next publishing action from Digital Menu 4. Check the Paper Menu publishing surface 5. Review the Bar Menu starting point --- # App Navigation Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. View the Dashboard 2. Open the Beverages section 3. Navigate to Kegs inventory 4. Browse the Kegs list 5. Open the Menus section 6. Navigate to Bar Menu 7. Browse the Bar Menu taplist 8. Open the user menu in the toolbar 9. Navigate to My Profile settings 10. Browse Profile settings --- # Reports Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk dashboard 2. Open the Sales reports workspace 3. Review the Items report when sales data is connected --- # Troubleshoot Sign In Problems > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Open the sign in page and orient yourself 2. See BevWerk catch an invalid email format before submit 3. See the friendly error message for incorrect credentials 4. Open the reset password flow when you need to recover access --- # Sign Up Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Navigate to the sign up page 2. Enter personal details 3. Enter company details 4. Set password and accept terms 5. Submit and verify account creation --- # Starter Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Navigate to app 2. Explore the dashboard --- # Subscription Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk dashboard 2. Open the Subscription workspace from the Company menu --- # Users Management Walkthrough > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk dashboard 2. Open the Users management workspace from the Company menu 3. Open the Add User form 4. Cancel out of the form without creating a user --- # Manage Events From The Settings Menu > This tutorial was auto-generated by [TDDocs](/) from a Playwright test recording. ## Steps 1. Start from your BevWerk dashboard 2. Open the events workspace BevWerk uses for this location 3. Review the tools BevWerk gives you for event content 4. Browse the supporting event publishing controls --- # Website & events This section is for the parts of BevWerk that shape what people see outside the core operational workspaces. ## Start here 1. [`Manage events`](/website/manage-website-content/) — understand the events manager BevWerk surfaces today for the demo workspace and how it supports public-facing updates. ## What this section covers - event management workflows - search and pagination for public-facing content lists - the bridge between internal setup and outward presentation - how website page editing appears once a location has website access ## Why this section matters Public-facing content is easy to treat as an afterthought. But once a business is operational, events and website updates are often the next surfaces that need to stay current. This section helps explain those workflows directly, starting with the events path the current demo workspace exposes. --- # Manage events This guide is for operators who need to update what guests or visitors see without digging through unrelated admin screens. ## What you'll learn By the end of this guide, you will know: - where BevWerk keeps the events manager when a location does not yet have website access - how the add-event form is separated from the event list - how search and pagination support day-to-day event upkeep - when website page editing becomes available for a location ## Why this matters Public-facing content is easier to trust when the product separates: - event management - list navigation for larger sets of content - website page editing for locations that have it enabled That structure gives operators a calmer way to maintain outward-facing information. ## Watch the walkthrough - [Open the events walkthrough](/tutorials/website-content-spec-manage-events-from-the-settings-menu/) ## Why this walkthrough starts with events instead of page tabs The current demo workspace does **not** have location website pages enabled, so BevWerk exposes the public-facing events manager directly from the toolbar settings menu. Once website access is enabled for a location, BevWerk also unlocks the dedicated website page-editing workspace. ## What this guide proves The events tools are not hidden behind one overloaded screen. BevWerk breaks them into clear workspaces so you can: - jump straight into event management from the toolbar - open the add-event form only when you need it - move through larger event lists without losing context ## What to do next - Return to [`Website & events`](/website/) - Revisit [`Publish your menu`](/publishing/publish-your-menu/) - Or move to [`Help & support`](/support/) for the self-serve guidance side of the product