Trellis Tools · Walkthroughs

Walkthroughs › MoClo Library Tool

MoClo Library Tool

One shared parts library, and the assemblies built from it

Read the library level by level, add a part with its fusion sites, build a transcription unit and watch the compatibility check as you go, read a Level 2 plasmid, work out the reaction mix, design CRISPR guides and their whole cloning route, and pick it all up again at the bench. Every step uses the demo library, so what you see on your screen matches the recordings here.

Versions Recorded on 13 November 2026 with Trellis 2.49.2 and MoClo Library Tool 1.22.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

The library, level by level

Golden Gate works because everyone's parts share the same fusion sites.

  1. 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.
  2. Look at a part's card.Above it, the 5′ and 3′ fusion sites — 5'-GGAG and AATG-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.
  3. Narrow the list with Filter by Type and Filter by Level, or search by name.Clear Filters puts it back.
  4. 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.
  5. 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.

Recording · The library, level by level
RecordingThe parts browser and its filters, then the cassettes and the backbones.
Parts
Every part with its fusion sites.
Filtered
Filter by type and level.
Cassettes
Level 1 units, drawn as their chain of parts.
Backbones
The acceptors each level assembles into.
2

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

Recording · Add a part
RecordingA promoter entered by hand, with its type, sequence, overhangs and source.
Upload New Part
By hand, from GenBank, or in bulk.
Filled in
The two 4 bp overhangs, and where it came from.
3

Build a transcription unit

Check compatibility before you order anything: the clash that would otherwise appear as an empty plate.

  1. Go to Cassette Assembly.The Level 0 parts on the left, each with its two fusion sites; the preview on the right.
  2. Add the parts in the order they go. Search for DEMO pNOS and click it.It becomes part 1. The preview says Assembly requires at least 2 parts until there is a chain.
  3. 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.
  4. 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.
  5. 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.

Recording · Build a transcription unit
RecordingA promoter, a coding sequence and a terminator joined through their fusion sites.
Cassette Assembly
Parts on the left, the preview on the right.
Only what fits
6 compatible, 33 hidden — all starting on AATG.
The chain
Each junction named, and the length.
Create Cassette
Name it and save it to the library.
4

A Level 2 plasmid

Several transcription units in one plasmid, each remembering what it was made from.

  1. Click the Plasmids tab.The Level 2 constructs. Each lists every part inside it, including the overlaps and end-linkers that chained them.
  2. 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.
  3. 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.
  4. 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.

Recording · A Level 2 plasmid
RecordingThe assembled plasmids, and one opened with its map and export options.
Assembled Plasmids
Each plasmid lists what went into it.
View Details
The backbone, the enzyme, and the map.
5

The reaction calculator

Work out the mix once, and have it at the bench when you do the reaction.

  1. 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.
  2. Scroll to the foot of it, to the reaction calculator.Or send a plasmid to it from its own page, already filled in.
  3. 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.
  4. 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.

Recording · The reaction calculator
RecordingFragments given their sizes and concentrations, and the mix worked out.
Protocol
The method, level by level.
Fragments
Size, concentration, and which is the vector.
The mix
An equimolar mix, with the cycling program.
6

The CRISPR designer

Guides, their oligos, and the whole route from guide module to Level 2 construct.

  1. 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).
  2. 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.
  3. 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.
  4. 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.
  5. 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.

Recording · The CRISPR designer
RecordingThe promoter, backbone and acceptor chosen, and a guide entered.
CRISPR Designer
The route, from guide to Level 2.
A guide
20 bp each; BpiI and BsaI sites are refused.
7

Saved constructs, and the rest of the suite

Pick the plan up again at the bench, and open anything in the Sequence Editor.

  1. 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.
  2. 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.
  3. Choose My parts for what you contributed to the library, with its type, lab source and when it was uploaded.
  4. 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.

Recording · Saved constructs, and the rest of the suite
RecordingThe dashboard's saved constructs and parts, then the MoClo library inside the Sequence Editor.
Saved Constructs & Plasmids
What you saved, ready to open again.
My parts
What you contributed to the library.
In the Sequence Editor
One library, both tools.

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.