-
Notifications
You must be signed in to change notification settings - Fork 20
Open
Conversation
A first visit tour of the search results page and the home page, made of anchored callouts that step with Next and Back and close with Escape. Nurro, the EyeWire II guide, sits on every card, a different illustration per step. The callout is scifi-ui's holotip (tutorial-callout.css and .js), the EyeWire II tutorial step reproduced. The one change to the script lets a step name its own guide sprite with data-holotip-guide. The Nurro block and sprites come from the Codex landing page. The tour runs once per browser, two seconds after load, on pages that list steps in a tour block. A Tour link in the nav replays it; on pages without a tour the link opens the home page tour. The once flag is only written when the visitor ends the tour, so a tour cut off by a page change comes back. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
...eam to downstream, toolbar pops Step one says Connectome Data Explorer. Step three points at the cell picture, which opens the cell page. Step four names two targets and moves between them every three seconds, bolding the matching word. Step five keeps the card on the analysis bar while each tool pops in turn. run_local.ps1 runs on Python 3.13, which Codex needs for datetime.UTC. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Chapter one on the results page ends by asking for a click on the cell picture; Next is hidden and the click is the step. The cell page opens on chapter two: the cell, then its wiring, then a click on the out link. That opens the downstream list in a new tab on chapter three, which ends the story. The chapter travels in localStorage with a half hour life, so a new tab or a reload picks up where the reader was; the Tour link always starts a page's own chapter from the top. Step two says: Let's figure out what these do. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
... empty downstream list A hand-off step hides Next because the click on its target is the step. With the target missing or off screen there is nothing to click, so Next stays. Chapter three on a page with no matches now says the snapshot has no partners recorded for the cell, instead of describing cells that are not there. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The letter reveal made every letter a flex item, so a long title broke in the middle of a word. Letters are now grouped by word. The classification step counts the extra column a downstream search adds. The motor neuron sentence says the signal is about to leave the nervous system, not that it has. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The 3D view now takes color_by=<attribute> (cell_type, super_class, class, nt_type, hemilineage): every cell that shares a value gets one colour from a fourteen hue palette, cells with no value stay grey, and the colours travel in the viewer state as segmentColors. A "3D by type" action sits next to 3D view on every results page. Chapter three of Nurro's story gains a step for it before the sign off. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
... order that leaves the brain Chapter three now ends on three doors, each a chapter on its own page that opens with ?tour=1 and only when the page shows that trail's query. Pathways: the 127 DA1 sensor cells to MBON11, three hops at five synapses or more. Network: DA1 relay cells, APL, DPM and two MBONs, with the 2,190 memory cells left off so the map stays readable. Stats: the 1,303 descending neurons, then an invitation to count the ascending ones. The arc runs signal, memory, orders; the action lives in the nerve cord. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Nurro's guided tour, and 3D by type
A short guided story for people arriving in Codex from outside, told in anchored callouts that point at one element at a time. Nurro, the EyeWire II guide, sits on every card with a different illustration per step. The first step meets a visitor landing on a results page, for example the DNp03 search that the Codex landing page opens, and the story then follows one cell to the cells that hear it.
The story
Results page. The search box, one row is one neuron, the analysis bar (each tool pops in turn), then "click the picture" to open a cell. The click is the step.
Cell page. The cell, its wiring (the card moves between the in and out links, bolding the matching word), then "click the out link".
Downstream list. The cells that hear it, the classification column, a new 3D by type action that opens the viewer with every cell coloured by its cell type, then the sign off.
Three more trails, offered on the sign off and each a chapter on its own page: Pathways from the 127 DA1 smell sensors to MBON11 (three hops at five synapses or more), the Network of DA1 relay cells, APL, DPM and two MBONs inside the mushroom body, and Stats on the 1,303 descending neurons with an invitation to count the ascending ones. Each page carries its chapter only when it shows that trail's query.
The chapter travels in localStorage with a half hour life, so the new tab the out link opens picks up where the reader was. The once flag is written only when the reader ends the tour, so a tour cut off by a page change comes back. A Tour link in the nav replays a page's own chapter; on pages without one it opens the home page tour. The home page has a four step tour of its own.
3D by type
search_results_flywire_urltakescolor_by=<attribute>(cell_type, super_class, class, nt_type, hemilineage). Every cell that shares a value gets one colour from a fourteen hue palette, cells with no value stay grey, and the colours travel in the viewer state assegmentColors. The "3D by type" action sits next to "3D view" on every results page and uses cell_type.Where it comes from
The callout is scifi-ui's holotip, the EyeWire II tutorial step reproduced (
tutorial-callout.css,tutorial-callout.js). Additions in this copy: a step can name its own guide sprite, walk between two targets, pop a group of elements, or wait for a click on its target and hand off to the next page's chapter. Titles wrap between words. The Nurro block and sprites come from the Codex landing page repo. Steps live in atourblock in each page's template, so a tour for another page is a list of<li>elements.Files
codex/templates/base.html: stylesheet includes, the Tour nav link, thetourblock and the two scripts.codex/templates/search.html,cell_details.html,index.html: the steps.codex/templates/results_actions.html: the 3D by type action.codex/blueprints/app.py,codex/utils/nglui.py:color_byandsegmentColors.codex/static/styles/tutorial-callout.css,tutorial-nurro.css,codex/static/js/tutorial-callout.js,tutorial-codex.js: the component, Nurro, and the first visit start.codex/static/assets/nurro.png,codex/static/assets/nurro/: the sprites.To check on staging
Open
/app/search?filter_string=cell_type+%3D%3D+DNp03&dataset=banc&tour=1, click through, click the picture, click the out link, then 3D by type. The Tour link in the nav replays any page's chapter.Verification
Rendered locally with headless Chromium at 1280x800 and 390x844, with real clicks through all three chapters: tour open by two seconds and not at one, every card and target on screen at every step, hand offs set and clear the chapter, Done writes the once flag, reload shows no tour, the Tour link replays without navigating, the 3D by type redirect carries a colour for all 15 downstream cells. No console errors or failed requests.
Selectors were checked against the rendered local page, not just the templates. codex.flywire.ai requires sign in, so I could not check them against production. The clean public tree cannot load the published data pickle on its own (
connections_v2import, a strict schema check, a newer Connections layout), so the local run used a loader fix from a separate branch; it is not part of this change.🤖 Generated with Claude Code