Trellis Tools · Walkthroughs

Walkthroughs › Lab Notebook

Lab Notebook

Write the day as it happens, linked to everything it touched

Write today's page, link a plasmid, scale a PCR mix, keep a week's to-do list, use a shared protocol, then find, share and export your work. Every step uses the demo notebook, so what you see on your screen matches the recordings here.

Versions Recorded on 13 November 2026 with Trellis 2.49.2 and Lab Notebook 0.26.1. Yours are under About in the tool's own header. If yours are newer, a screen here may have moved on; if they are older, something on this page may not be there yet.

Before you start

  1. Have Trellis running: on a lab server, or on your own computer for practice (install).
  2. Load the demo. It adds two teaching labs, their accounts and example work in every module, and leaves your lab's own records alone. On the server, in the Trellis folder:
    demo/demo.sh load
  3. Sign in as demo, password trellis-demo (or the one set with DEMO_PASSWORD).

To start the walkthrough again from a clean slate, run demo/demo.sh reset. The recordings are silent; each step is named in the green caption at the bottom.

1

Today's page

Write on the day, not at the end of the week: one press opens today's page.

  1. On the Trellis home page, click Lab Notebook.On the left: your notebook, days filed under months and years, newest first; your favourite protocols; and Deleted, where nothing is ever really lost.
  2. Press Today.Today's page opens, named for the date and filed under its month and year, which are made for you. Pressing it again later opens the same page.
  3. Look at the top of the page.A booking for today, from Booking, is shown there with a box for what was done, so the page knows which machine you were on. The demo has a PCR machine booked.
  4. Click in the page and write what you are doing.The page saves itself a second after you stop typing; the header says when it was last saved.

One page, one piece of work. Keep the day page for the day. For an experiment that runs over several days, make a page of its own with + next to a page in the tree, and link to it from each day.

Select text to format it. A bar appears with bold, italic, colours, a highlighter, headings and lists. Start a line with - for a bulleted list.

Recording · Today's page
RecordingToday's page opened, with the day's booking at the top, and a first line written.
Lab Notebook
Your notebook, and the lab's favourite protocols.
Today
Today's page, with its booking shown at the top.
3

A table that scales

Put numbers in a table, not a sentence: it does the arithmetic and can be read later.

  1. Under the page, next to Add:, click ▦ Table.A new table is ready for a reaction mix: Component, Per reaction (µL), a Total that is a formula, =B*N, and an Added column to tick.
  2. Give the table a name, then fill in one reaction: each component and its volume.+ Row adds a row.
  3. Type the number of reactions in Reactions, at the top of the table: 26.Every Total is multiplied by it: 10 µL of master mix becomes 260 µL.
  4. Tick Added as each component goes in.The tick keeps who ticked it and when.

Columns of your own. ⚙ Columns sets what each column is: text, a number, a formula, scaled by reactions, filled in on the day, or a tick box. Formulas start with =: =B*C for the same row, A1:A5 for a range, and SUM, AVERAGE, ROUND and IF work.

From a spreadsheet. A table copied from Excel, Google Sheets, LibreOffice or Word pastes straight in, keeping its rows and columns.

Recording · A table that scales
RecordingA PCR mix for one reaction, scaled to 26, and the first component ticked.
One reaction
The mix for one reaction.
26 reactions
Scaled to 26: the totals follow.
4

The week's to-do list

One list for the week, shown under every day of it: added on Tuesday, still there on Thursday.

  1. On today's page, click + Week's to-do.The list for this week, Monday to Sunday, is made and opens. Anything moved on from last week is already on it. On a week that has one, the button opens it.
  2. Click + Task and type a task.Enter starts the next one; Backspace in an empty one removes it. Type @ to tag a plasmid, stock or seed lot, as anywhere else.
  3. Tick a task when it is done.The tick says who and when.
  4. Click → Next week on a task that will not get done this week.It stays on this week's list, greyed out and marked as moved, and appears on next week's list saying where it came from. Bring back undoes it.

Who can change it? Whoever can change the day page can change its week's list; anyone who can only read it sees it as it is.

Recording · The week's to-do list
RecordingThree tasks added, one ticked off, one moved on to next week.
To do · week 46
The week's list, a page of its own.
Ticked and moved
One ticked, one moved on to next week.
5

Use a protocol

One shared copy of each method; each day keeps the version it used.

  1. Under Favourite protocols on the left, click Floral dip transformation (Arabidopsis).The Protocols library is shared by the lab. All protocols → lists the rest; ★ Favourite keeps one on the left.
  2. Click + Add to page….It asks where to put the protocol: Add to today first, or search for any page or day of yours.
  3. Choose Add to today.The protocol becomes a page of its own under today's page, named for the protocol and saying which version it came from.
  4. Tick the steps as you work.Each tick keeps who and when. What you write stays in your copy; the library's protocol is untouched.

Improving a protocol does not change the days that already used it: they keep the version they were done with. The protocol lists every page it was used on under Used on.

Already on a day page? Protocol… under the page puts a copy into the page itself.

Recording · Use a protocol
RecordingThe floral dip protocol added to today, and its first steps ticked.
Protocol library
The lab's protocol, in the library.
Add this protocol to…
Add to today, or any page of yours.
Under today
Your copy, under today, with the steps ticked.
7

Share, history and export

Work together on a page, go back to any earlier version, and take a copy away.

  1. On a page, click Share and choose a lab or a person, then Share.They can read it, or write in it too. A page someone shared with you appears under their name in the tree. In the demo, the T2 trial's sowing page is shared with the partner lab.
  2. Click History.Every saved version, newest first, with who saved it. View opens one, and it can be restored.
  3. Click ⤓ Export and choose PDF, to keep, print or send, or a Word document, to edit.Either can take every page underneath with it, so a whole project or a whole year goes in one file.

Who reads whose notebook follows the lab's roles unless a page is shared: a member reads only their own; a lab lead reads their lab's notebooks except a lab admin's; a lab admin reads them all. Only the owner writes in their notebook.

Two people at once? The notebook says so rather than overwriting, and shows what the other person saved.

Recording · Share, history and export
RecordingThe Share, History and Export dialogs of the T2 results page.
Share
Share with a lab or a person.
History
Every saved version.
Export
Export as PDF or Word.

Where next

  • The Sequence Editor walkthrough follows the plasmid you linked here, from its map to the confirmed clone.
  • The notebook's own Help page (Help, top right in the notebook) covers steps, gel photos, attachments and fixing mistakes.