Onboarding wizard
The first time you open SafetyBrik you land on the onboarding wizard at /safety/onboarding. Its job is to take you from "blank account" to "ready to run a service" in a single sitting, ideally without making you re-type a single thing you already have on paper.
Why the page is called "Import records"
Almost every UK caterer who finds SafetyBrik already has an SFBB pack. It might be the official FSA booklet from 2011, a folder of printed-out fridge logs, a Word document a consultant put together, or a cleaning rota pinned up by the sink. The onboarding wizard is built around that reality. Rather than asking you to set up your equipment, cleaning schedule, and chemical register from scratch, it asks you to upload what you already have and lets the AI do the typing.
That is why the page title is "Import records" rather than the more generic "Onboarding" or "Welcome".
What the wizard sets up
The wizard runs through seven steps, and you only see the review steps that match the documents you actually upload.
1. Upload
Drop your existing safety documents onto the upload step: PDFs or photos (JPG or PNG), up to 10 MB each. Photos of paper records work as well as PDFs - large photos are made smaller for you before they go to the model. The documents you upload are kept privately while you import them, then deleted after a week (a data sheet you confirm stays with its chemical in the COSHH register). SafetyBrik can import three kinds of document:
- Equipment lists (fridges, freezers, hot-holds, probes)
- Cleaning schedules (daily, weekly, deep-clean rotas)
- COSHH data sheets (sanitiser, oven cleaner, descaler)
Anything else, such as a supplier list or a delivery check sheet, shows as Unknown at the next step and isn't imported.
A file that can't be used is listed under "These files weren't added:" with its reason: "Use a PDF, JPG or PNG." for any other kind of file, "This photo is in HEIC format. Save it as a JPEG and try again." for a HEIC photo, or "Too big. Keep each file under 10 MB." for a file still over 10 MB once photos have been made smaller.
2. Classify
SafetyBrik uses Gemini to classify each uploaded file as an equipment list, a cleaning schedule or a COSHH data sheet, or Unknown when it can't tell. Under Use as you can correct a type, choose one for an Unknown file, or set a file to Skip - if it has misread a delivery note as a cleaning schedule, just change the dropdown. Skipped files, and files left as Unknown, are not imported.
With more than one site, choose the Site each document is for: its records go to that site. An equipment list or a cleaning schedule can be for All sites; chemicals are always at one site. The wizard waits until every document has a site ("Choose the site for each document."). A business with one site isn't asked: everything goes to its one site. Switched-off or removed sites aren't offered.
If nothing in the files can be imported, the page says so and offers Upload different files or Skip for now.
3. Extract
For each classified document the wizard runs an extraction pass. This is where the actual data - the fridge model and target temperature, each cleaning task and how often it is done, the chemical name and PPE requirements - is pulled out of the image or PDF into structured records. You see live progress as each file is processed. Several documents of the same type, such as two cleaning schedules, are added together and reviewed as one list.
If a file can't be read, or has nothing in it to import ("We couldn't find anything to import in this document."), it is marked with the reason and the page says "Some documents couldn't be read". Choose Continue with the rest to review what was found. When storage is briefly unavailable, the wizard says "We couldn't open that document just now. Please try again in a moment, or upload it again." rather than asking for clearer copies. A document uploaded more than a week ago has been deleted, so a step that reads it again says "This upload has expired. Upload the document again."
Each review step below has a button to leave that document out (Don't add this equipment, Don't add this schedule or Don't add these chemicals), and a remove button on every row, so you can leave out anything the AI got wrong without abandoning the rest. A row that needs fixing is highlighted, with the reason under the field, and the screen says "Fix the highlighted rows to continue." The confirm button (for example Confirm & create 12 equipment items) waits until every row is right. If the import is refused when you confirm, the reason shows on the rows it names, and nothing from that screen is added.
4. Review equipment
If any uploaded document was classified as an equipment list, you see a review screen with the fridges, freezers, hot-holds, and probes the AI extracted. Each row is editable: change the name or type, adjust the Range (°C) thresholds, or remove a row. With more than one site, each row has a Site, starting from the site you chose for its document (in an All sites list, a row that names one of your sites starts at that site): one of your sites, or All sites (shared, e.g. a probe). When the document named a place, the row shows it, for example "The document says: back kitchen", and a fridge, freezer, hot hold or display left at All sites reminds you to choose its site: "A fridge belongs to one site. Choose its site so it can be checked on that site's checklists." A row the document gives no range for starts from its type's default safe range, marked Suggested: 0 to 5°C for a fridge, -18°C or colder for a freezer (no lower limit, so a colder freezer is never flagged), 0 to 8°C for a display and 63°C or above for a hot hold. Changing a row's type swaps a suggested range for the new type's default. A range the document gave, or one you typed, is kept. Confirmed rows become live records on the Temperature checks page.
The wizard puts a lone limit on the side its type needs, and flags it for you to check: a freezer's "-18" read as a minimum becomes its maximum, and a hot hold's "63" read as a maximum becomes its minimum. A starting range that would put the minimum at or above the maximum is left empty and flagged instead.
Every row is checked before any is saved, so an import is never half done. A row's problem shows under it: a name that is missing ("Give this a name.") or too long ("Keep the name to 255 characters."), a type to choose ("Choose what type of equipment this is."), or a range that would flag good readings, for example "A fridge needs a maximum, for example 5°C. Check the range and try again." A range too large to store (over 999.99°C) reads "That range is too large to record. Check the minimum and maximum and enter them again.", and a temperature that isn't a number "Enter this temperature as a number." The same range rules apply as on the Temperature checks page. Nothing is imported until every row is fixed.
5. Review cleaning
If a cleaning schedule was extracted, you review the schedule name and, for each task:
- How often it is done: After use, Every shift, Daily, Weekly, Monthly, or Other. For Other, say how far apart it is done (every so many days, weeks or months, up to a year), with an optional name such as Quarterly. Changing the interval clears the name. A frequency the AI wasn't sure of is flagged for you to check.
- Whether it is ticked off or needs a photo (Tick or Photo).
- With several sites, its Site.
A task can be up to 200 characters ("Keep this to 200 characters."), and the same task twice at one site is refused: "This task is listed twice for the same site. Remove one, or change the words."
Confirming makes, for each site, one daily checklist (its daily, after-use and every-shift tasks), one weekly and one monthly, as needed. They are named after the schedule: "Kitchen cleaning" when a site gets one checklist, or "Kitchen cleaning (daily)", "Kitchen cleaning (weekly)" and so on when it gets more than one. A weekly checklist runs on Mondays and a monthly one on the 1st. Other tasks go on the cleaning schedule only, never on a checklist. Every task also goes on your Cleaning schedule with its own frequency at its site, so it appears in your SFBB Section 10 record without a second pass. A task the schedule already has under that name at that site isn't added to it again. A daily, weekly or monthly task still goes on its new checklist, so a schedule with any of those always makes its checklists, and the summary counts all its tasks, for example "Cleaning schedule 'Kitchen cleaning' added: 1 checklist, 5 tasks". Only a schedule of Other tasks that were all on the cleaning schedule already adds nothing, and says so, for example "Cleaning schedule 'Kitchen cleaning': its 5 tasks were already on the cleaning schedule, so nothing was added."
Your imported schedule takes the place of the default cleaning checklists and the default cleaning tasks like with like. Where it makes a daily checklist for a site (every open site, for an All sites schedule), it replaces that site's default daily cleaning: the Daily Cleaning Schedule checklist and the default after-use, every-shift and daily tasks. Where it makes a weekly checklist, it replaces the default weekly cleaning: the Weekly Deep Clean and the default weekly tasks. A monthly checklist replaces nothing, as there are no monthly defaults. So a site whose schedule is only a weekly deep clean keeps the default daily cleaning. A default task with the same name as one of your tasks gives way to yours wherever your task is.
- In first-time setup, each default your schedule doesn't replace anywhere is added for All sites, and one it replaces at some sites is set to each of your other open sites. You still get the default Opening and Closing routines.
- On a later import, after the defaults have been added, it replaces the default cleaning checklists nobody has used and the default cleaning tasks nobody has used or edited, where it takes their place. A default in use stays as it is. An All sites default it replaces at some sites is kept, as a copy, at your other open sites.
- A site given only Other tasks keeps, or is given, the defaults. A schedule of only Other tasks makes no checklist and replaces no default routine: only a default task with the same name as one of its tasks gives way to it, where it brings that task.
When the import replaces default cleaning that was already there, or gives your other sites the defaults, the audit log records Default cleaning replaced by an import. After an import for some of your sites, the default cleaning it replaced there is kept as copies at the sites open at the time. A site added (or switched back on) later starts without those defaults (for example without the weekly ones after a weekly-only import): add its cleaning yourself, or import a schedule for it.
6. Review COSHH
If COSHH data sheets were uploaded, you review each chemical's name, brand, use, PPE, storage and dilution and, with several sites, its site. A chemical is always at one site, never All sites ("Choose the site for this chemical."). Every chemical needs a name: if one is cleared, the field says "Give this a name." and you can't confirm until it has one. Long text is checked on the row rather than cut short, for example "Storage is too long. Keep it to 255 characters." Each chemical's own data sheet is linked to it automatically. Data sheets are stored privately: in the COSHH register the green version badge opens the sheet through a link that expires after 15 minutes. This populates the COSHH register.
7. Complete
The complete step shows a summary of what was added, for example "Cleaning schedule 'Kitchen cleaning' added: 2 checklists, 14 tasks". When all you confirmed was cleaning schedules of Other tasks already on the cleaning schedule, it reads Nothing new to add, with "Everything you confirmed was already on your records, so nothing was added." Equipment and COSHH chemicals are always added, and so are the checklists a schedule makes. If every document was skipped, it reads Nothing imported, with "Nothing was imported this time. You can import records later from the Overview."
Documents that weren't imported are listed under "Some documents weren't imported", one line each, for example "Not imported: menu.pdf. We couldn't tell what kind of document this is.", with "Everything else you confirmed has been added. Add what's missing yourself, or import it again later." When everything else you confirmed was such a schedule, it says "Nothing else was added: everything you confirmed was already on your records. Add what's missing yourself, or import it again later."
Setup is saved as done as soon as the first document's records are added (or when you choose Skip for now), so leaving partway through never sends you back to the wizard: from then on, opening /safety takes you straight to Today, the SafetyBrik home. Once your documents have been read, the review saves as you go, so you can pick it up again from Import records (/safety/import): see Continuing an import later.
The upload step says "No paperwork to hand? You can import it later from the Overview." Choose Skip for now (on the upload step or the classification step) to finish setup and go straight to Today. From there you can add equipment, cleaning schedules and chemicals by hand, or click Import records on the Overview when you have dug the old folder out from under the till. The Overview keeps that prompt until you have registered any equipment, unless you dismiss it.
Importing needs an owner, admin or team member. Someone with view-only access sees "Importing records needs an owner, admin or team member." with Back to Today instead of the wizard, and doesn't get the Overview's import prompt. Until setup is finished, a viewer who opens SafetyBrik or the wizard sees "Your team is still setting up SafetyBrik. Ask an owner or admin to finish it." instead (see When a Brik is still being set up).
Continuing an import later
Once your documents have been read, the review saves as you go, so you can leave partway through and carry on later. A status line over each review step says how saving is going: Saving..., then Saved at 14:32 (your business's time), or Not saved. Retrying... if the connection dropped, with Retry to try straight away.
Before your documents are read, nothing is kept. While files are being classified and read, the page says "Your progress is kept once your documents have been read. If you reload or leave before then, you'll need to upload them again."
Picking it up again
Open the import again (the wizard, or Import records at /safety/import) and the upload step shows each unfinished import on its own card, for example "Continue your import from Tue 10 Nov, 14:32" and "You can continue this import until Sat 14 Nov.", with Continue and Start again. Continue takes you back to the step you were on, with your changes. Start again asks first: "Your progress on this import will be discarded. Anything you've already added stays.", with Start again and Keep it.
An import is kept for 7 days after its last change. It can be less when a step still needs an uploaded COSHH data sheet: uploads are deleted a week after they were uploaded, so the import ends when the earliest sheet it still needs is due to be cleared. Only the person who started an import sees it: nobody else in the business can continue or discard it. An import that has run out shows This import has expired, for example "Your import from Tue 10 Nov, 14:32 can't be continued any more. Upload the documents again to import them.", with Dismiss. A finished import (one that reached the summary) isn't offered again.
Confirming a step
When you press Confirm, the step's rows lock, and your progress is saved before anything is added. If that save can't be made, nothing is sent: "We couldn't save your progress on this import, so nothing was added yet. Check your connection and try again."
- No answer. If Confirm gets no answer (the connection dropped, say), the rows stay locked, and the step can't be left out, with "We couldn't tell whether these were added. Press Confirm again: they're sent with the same details, so nothing is added twice." Pressing Confirm sends the same confirm again, and it is answered just as the first one was, so nothing is added twice. If you leave and continue the import later, that confirm is sent again by itself as the step opens. Until it is answered, the rows say "These were sent, but we haven't heard back yet. Press Confirm to finish: nothing is added twice."
- Refused. If the confirm is refused, nothing from that step is added, and the rows open again with the reason, so you can fix them and confirm again.
- Can't be continued. If the import has expired or been discarded, or an upload a step needs has been deleted, the page says This import can't be continued, with the reason (for example "This import is no longer saved. It may have expired or been discarded. Start the import again.") and Start again, which takes you back to the upload step.
Earlier visits and other tabs
Changes that hadn't saved on an earlier visit on this device, or in another tab, are never mixed into the import. Where they differ from it, they show read-only under "Changes to this import from an earlier visit", step by step (for example Equipment (3)), with "They can't be added back automatically. Check them and enter anything you still need, then discard them." and Discard. Confirm waits until they're discarded: "There are changes to this import from an earlier visit. Check them, discard them, then confirm again."
Another tab with unsaved changes to the same import shows Another tab has unsaved changes to this import, with "Finish them there or close that tab, so one tab carries on with this import.", and Confirm stops until it's done: "Another tab has unsaved changes to this import. Finish them there or close that tab, then confirm again." If the import was saved in another tab after you opened it, Confirm adds nothing and says "This import was changed in another tab, so nothing was added. Reload it to carry on."
Leaving the review while a change hasn't saved yet asks Leave this page?, with Leave and Stay, for example "Your latest changes haven't been saved yet. We'll try to send them now, and anything that doesn't get through is sent next time you open this import." Once the import reaches the summary, there's nothing left to keep and leaving doesn't ask.
What if the wizard misses something?
The wizard is a head-start, not a one-shot. Anything you change later - new fridge, new chemical, new cleaning task - is added through the relevant feature page, and you can run a second import pass at /safety/import whenever a new batch of documents shows up. That page has Back to Today in place of Skip for now, so you can leave without importing anything.
If the connection drops while you confirm a review screen, confirming again never adds its records twice (see Confirming a step).