FZFish

🔐 Signing In

Click Sign in with Google using your @bu.edu Google account that has access to the shared inventory google drive. Your session stays active until you sign out. Use Test Mode to explore without saving anything.

➕ Adding a Tank

Click + Add Tank (desktop) or the + button (bottom-right on mobile). You may also scan a new barcode to begin adding.

• Attempt to scan the barcode with 📷 (The barcode text is in the bottom left of the label!). If the fish is in the incubator it will auto-generate a Tank ID. However please put barcodes on as soon as possible — you will thank yourself later!
• Fill in the line name using A:b;C:D x Z formatting (Ex. dbh:eGFP;CD4:mCherry x CD8:eGFP).
• Add the genotype using +;-/? formatting (In the example above: dbh+, CD4−, CD8 questionable).
• Input locations using Rx Sy or Nx Sy where R/N are the rack or nursery locations and S is the shelf, going up in value from the ground.
• Put any important notes in the notes section, including uncertain genes.

🧬 Markers

Positive markers (green tags) are transgenes confirmed present. Negative markers (red tags) are transgenes confirmed absent. Add them using the dropdown pickers when editing a tank. Once added to any tank they appear as filter options across the app.

For uncertain genes, put them in the notes as Gene? — they will be indexed by search and show up.

🏷️ Status

Set the tank's current status when adding or editing. Statuses are also used to filter the inventory:

• Active — Adult fish living on the rack.
• Nursery — Fish in the nursery system.
• Incubator — Embryos or early larvae currently in the incubator.
• Low Stock — Fewer fish than desired; flag for expansion.
• Breeding — Currently set up in a breeding cross.
• Archived — No longer active; kept for record.

🏞️ Pictures

Please add photos to each tank at each stage — this includes embryo plates — to make inventory easier for anyone working on your project. Photos are automatically saved to the shared Google Drive folder if you ever need the original.

📷 Barcode Scanning

Tap the 📷 icon in the header to scan a tank barcode. The app will jump straight to that tank, or start a new tank entry. You can also scan while adding or editing a tank to fill in the Tank ID field automatically.

✏️ Editing, Moving Tanks & Deleting

Click any tank card to open the detail panel. From there you can Edit all fields or Delete the tank. Changes sync to the shared Google Sheet immediately. If you are moving a tank, be sure to update its status and location in the inventory. All changes are saved to a changelog tab on the sheet.

🔍 Searching & Filtering

Use the search bar to find tanks by line, genotype, location, notes, or marker. Use the status chips (Active, Nursery, Incubator…) to filter by status. Use the +Markers / −Markers dropdowns to filter by confirmed presence or absence of transgenes. On mobile, tap ⚙ Filters to access all options.

🧪 Experiments

Use 🧪 ▾ in the header to create or open an experiment. Experiments are named collections of tanks stored as separate tabs in the same Google Sheet.

• Click + New in the dropdown to create one.
• Once inside, click + Add Tanks to pick tanks from the inventory.
• Click ✕ Remove on a card to remove it from the experiment without deleting it.
• Rename an experiment by clicking ✏️ in the experiment bar.
• Click ✕ Exit to return to the full inventory.

⟳ Syncing

Click the ⟳ button to pull the latest data from the Google Sheet. The app syncs automatically on sign-in. All edits are written directly to the sheet — no manual export needed.