Before you start
- Have Trellis running: on a lab server, or on your own computer for practice (install).
- 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
- Sign in as
demo, passwordtrellis-demo(or the one set withDEMO_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.
The library, level by level
Golden Gate works because everyone's parts share the same fusion sites.
- On the Trellis home page, click MoClo Library Tool.It opens on Parts: the Level 0 building blocks your chair group shares. A part an administrator adds is seen by every lab.
- Look at a part's card.Above it, the 5′ and 3′ fusion sites —
5'-GGAGandAATG-3'for a promoter — drawn where they sit. Below, its type and what it is. Those 4 bp overhangs decide where the part can go; everything else about a part can be fixed later. - Narrow the list with Filter by Type and Filter by Level, or search by name.Clear Filters puts it back.
- Click the Cassettes tab.Level 1: whole transcription units — promoter, CDS, terminator — each drawn as its chain of parts, with its length and how many parts went in.
- Click the Backbones tab.The acceptor vectors each level assembles into: a Level 1 acceptor takes Level 0 parts (GGAG…CGCT), a Level 2 acceptor takes a cassette or a chain of them. Compatible Cassettes on one shows what will go in it.
The levels, in short: Level 0 is a single element (promoter, CDS, terminator, intron), cut with BsaI into Level 1; Level 1 is one working transcription unit, cut with BpiI into Level 2; Level 2 is several units in one plasmid. Each level uses a different enzyme, so the level below is never disturbed.
No internal sites. A Level 0 part must not contain BsaI, and a Level 1 plasmid must not contain BpiI, or the enzyme cuts the thing you are building. The tool checks — but domesticate before you order the synthesis, not after.
Add a part
A part whose promoter, CDS and terminator are marked is usable by the whole lab; a bare sequence is a mystery in six months.
- Click the Upload tab.Three ways in: Manual Entry for a pasted sequence, GenBank File for an annotated file, and Bulk Upload for a whole set at once.
- Give it a clear name and the right part type: coding, non-coding promoter, non-coding terminator, intron, other, or an expression cassette for a Level 1 unit.
- Paste the DNA sequence, including the overhangs.The length and GC content are worked out as you type; only A, T, C and G are allowed.
- Set the 5′ and 3′ overhangs — exactly 4 bases each.Take them from the standard for the part's position, not from the sequence by eye. These are the contract: they decide where the part can sit in an assembly.
- Fill in the lab source, so the tube can be found and the work credited, then Upload Part.It is then in your chair group's library: every lab of the group can use it, and so can any chair group yours shares with.
Annotate before you upload. MoClo's Help page has an annotation guide: mark the real feature boundaries, use consistent names and types, and leave out the vector the part arrived in.
Already have it as a plasmid? In the Sequence Editor, tick a plasmid Golden Gate ready and contribute it straight to this library. The editor first checks that one enzyme releases a single clean insert with two fusion sites, and says why if it cannot.
Build a transcription unit
Check compatibility before you order anything: the clash that would otherwise appear as an empty plate.
- Go to Cassette Assembly.The Level 0 parts on the left, each with its two fusion sites; the preview on the right.
- Add the parts in the order they go. Search for
DEMO pNOSand click it.It becomes part 1. The preview says Assembly requires at least 2 parts until there is a chain. - Clear the search.The list now shows only the parts that fit: six compatible parts, thirty-three hidden, each marked ✓ Compatible — every one of them starting on
AATG, the site the promoter ends on. - Add the coding sequence,
DEMO CDS tag, then the terminator,DEMO t35S.Between each pair the preview writes ✓ Compatible junction (AATG) and (GCTT): the overhangs that will actually join them. - Read the summary: 3 parts, 1,453 bp, status ✓. Name the cassette and click Create Cassette.It joins the Level 1 library, keeping the parts it was made from. Use ▲ ▼ to reorder a part and ✕ to drop one.
What the checker looks for: overhang clashes, where two parts offer the same fusion site so the order is ambiguous, and gaps, where nothing joins one part to the next — plus internal enzyme sites, a BsaI site inside a Level 0 part or a BpiI site inside a Level 1 plasmid. It names the part at fault and why, not just that the set will not work.
A part will not go in? Check its overhangs first. They are the usual cause, and they are easy to mistype.
A Level 2 plasmid
Several transcription units in one plasmid, each remembering what it was made from.
- Click the Plasmids tab.The Level 2 constructs. Each lists every part inside it, including the overlaps and end-linkers that chained them.
- Look at pDEMO-L2 tRFP-reporter-tag, 4,349 bp.Three transcription units joined end to end: p35S>tRFP, pMAS>reporter and pNOS>tag, with the start- and end-linkers that carried each one's overhang to the next.
- Click View Details.Its size, how many cassettes, when it was made, the backbone it went into, the method and the enzyme —
BpiI · Level 1 → Level 2— and its map. - Export it: GenBank, SnapGene, FASTA, or the map as Map (PNG) or Map (SVG). Add to notebook puts it on a day page.+ Assemble New Plasmid builds another from cassettes the same way chapter 3 built one from parts.
Assembled the wrong thing? Delete the plasmid and assemble again. The parts it used are untouched.
A product the right size but wrong inside? Open it and read the parts it lists, rather than trusting the length.
The reaction calculator
Work out the mix once, and have it at the bench when you do the reaction.
- Click the Protocol tab.What MoClo is, level by level, with the standard overhangs for each part type, the Level 2 position overhangs, the thermal cycling program and the bench procedure.
- Scroll to the foot of it, to the reaction calculator.Or send a plasmid to it from its own page, already filled in.
- Give each fragment a name, its size in bp and its concentration in ng/µL, and set its role — insert, or vector/backbone. + Add DNA Fragment adds another.
- Click Calculate Reaction Mix.An equimolar mix: how much of each fragment, the buffer, ATP, the Type IIS enzyme, T4 DNA ligase and water, with the total volume. The notes give the molar ratio used, the enzyme for that level, and the cycling program.
Into the notebook. The same mix goes straight into a Lab Notebook day page as a table, so what you pipetted is recorded where the rest of the day is — and the table can be scaled by the number of reactions.
Picking it up again: a reaction saved to your dashboard opens the calculator already filled in.
The CRISPR designer
Guides, their oligos, and the whole route from guide module to Level 2 construct.
- Click the CRISPR Designer tab.It builds a polycistronic tRNA–sgRNA strategy after the Hahn et al. (2020) plant genome-editing toolkit, into the MoClo Level 1 and Level 2 vectors of Weber et al. (2011).
- Choose the Pol III promoter (wheat U3 or U6, Arabidopsis U6…), the sgRNA backbone — improved or classic — and the Level 1 acceptor position the guide cassette will fill.
- Paste the guides, 20 bp each, one per box; + Add guide adds another.A guide containing a BpiI (
GAAGAC) or BsaI (GGTCTC) site is refused, because the reaction would cut it. Up to six. - Under Level 2 construct parts, name the Cas nuclease and the resistance / marker Level 1 parts from your library, and any other Level 1 parts to include.
- Click Generate cloning strategy.It designs the guides and their oligos and plans the whole route: the Level −1 guide modules, the Level 0 parts, the Level 1 plasmid and the Level 2 construct. Name the records it will make, then let it make them — they appear in the library like any others.
Keep the protocol. Save to dashboard at the end keeps the whole thing, and View protocol regenerates it exactly as it was, so it can be read again later without redesigning it.
In the demo, this is what built tRFP-KO_plasmid: two guides on tRFP under AtU6-26p, assembled into a 7,633 bp Level 2 construct with a Cas9 unit and a kanamycin unit.
Saved constructs, and the rest of the suite
Pick the plan up again at the bench, and open anything in the Sequence Editor.
- Open your Dashboard and choose Saved constructs.What you saved from a plasmid or from the CRISPR designer. A title, or Open plasmid ↗, opens the plasmid itself — or the cassette, for a single transcription unit.
- Open a saved reaction to pre-fill the reaction-mix calculator.That is how you pick it up at the bench, and again when it needs repeating. For a CRISPR construct, View protocol regenerates the whole protocol.
- Choose My parts for what you contributed to the library, with its type, lab source and when it was uploaded.
- In the Sequence Editor, open My sequences.The MoClo library is on the right: any part, backbone or assembled plasmid can be imported with → import, because both tools share one library.
What the editor adds: restriction analysis, a virtual gel, primer design and sequencing-read alignment on the same record. A plasmid confirmed by its reads there gets its glycerol stock in Lab Stocks.
Not sure a saved construct is still right? Open it from the dashboard. If its plasmid has been deleted, the row says so rather than giving a broken link.
Where next
- The Sequence Editor walkthrough opens the plasmid you assembled here: its map, a digest, primers, and the sequencing reads that confirm the clone.
- The Lab Notebook walkthrough shows the reaction mix as a table on a day page, scaled to the number of reactions.
- MoClo's own Help page (Help, top right) has the annotation guide for parts, and what to do when a part will not fit.