Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
67 commits
Select commit Hold shift + click to select a range
fd8883c
Multiple projects storage foundation (#1327)
microbit-matt-hillsdon Sep 14, 2026
eef8bad
Projects pages (#1330)
microbit-matt-hillsdon Sep 15, 2026
42423ff
Merge branch 'main' into home-page
microbit-matt-hillsdon Sep 15, 2026
cc8c0f8
Tweak docs for current state
microbit-matt-hillsdon Sep 15, 2026
183164b
Enable welcome for REVIEW stage
microbit-matt-hillsdon Sep 15, 2026
314707b
Decouple flag tests from values in use
microbit-matt-hillsdon Sep 15, 2026
a12adcb
Swap files tab header from editable project name to fixed title and d…
microbit-robert Sep 16, 2026
cababa0
Update home page banner (#1337)
microbit-grace Sep 16, 2026
66c0fdf
Merge branch 'main' into home-page
microbit-robert Oct 19, 2026
8d824d6
Run i18n:tidy
microbit-robert Oct 19, 2026
88df3c4
Update home page (#1356)
microbit-robert Oct 19, 2026
b69cb2f
Label teacher resource cards with the kind of resource
microbit-robert Oct 27, 2026
6a79b46
Use 4:3 images for idea cards
microbit-robert Nov 2, 2026
7b38442
Merge branch 'main' into home-page
microbit-robert Nov 3, 2026
e8c337b
Move the home link into the sidebar header
microbit-robert Nov 3, 2026
875bef0
Bump theme
microbit-robert Nov 3, 2026
258e3bd
Open ideas from the home page in a dialog
microbit-robert Nov 3, 2026
9757074
Use use() for context in two remaining hooks
microbit-robert Nov 3, 2026
b418f54
Settings and help buttons on dark background
microbit-robert Nov 6, 2026
0adccd3
Merge branch 'main' into home-page
microbit-robert Nov 17, 2026
ad9c744
Merge branch 'main' into home-page
microbit-robert Nov 18, 2026
a1bebfa
Label the home page header link "Home" and hide its logos
microbit-robert Nov 18, 2026
cfd4721
Merge branch 'main' into home-page
microbit-robert Nov 18, 2026
caca663
Add a project breadcrumb above the editor (#1420)
microbit-robert Nov 18, 2026
c4b7d08
Link the beta notice band to the current editor
microbit-robert Nov 18, 2026
25b8f1c
Restore lost translations
microbit-robert Nov 19, 2026
ac48200
Show one toast when creating a project fails
microbit-robert Nov 19, 2026
e97b012
Create one project from repeated clicks in the idea dialog
microbit-robert Nov 19, 2026
5001b77
Set the projects selection toolbar's border colour in one rule
microbit-robert Nov 19, 2026
0660a85
Give the home page and editor distinct h1s
microbit-robert Nov 19, 2026
c0a10a6
Add axe scans for the home and projects pages
microbit-robert Nov 19, 2026
31cfc64
Remove a stale comment and fix a doc reference
microbit-matt-hillsdon Nov 20, 2026
95508b2
Remove strings nothing uses
microbit-matt-hillsdon Nov 20, 2026
80a518d
Log project_import from the projects page as its own surface
microbit-matt-hillsdon Nov 20, 2026
9666225
Precache the home page's JPEG card images
microbit-matt-hillsdon Nov 20, 2026
fa5733e
Report is_default for projects from the projects database
microbit-matt-hillsdon Nov 20, 2026
9cff3e5
Stop a failed project load wiping the project
microbit-robert Nov 20, 2026
c78dc4c
Don't refresh the project list when creating a project
microbit-robert Nov 20, 2026
8b735ea
Report a failed project load on a home page already showing
microbit-matt-hillsdon Nov 20, 2026
26446fa
Give the first project the same storage as later ones (#1425)
microbit-matt-hillsdon Nov 20, 2026
facd7b1
Keep edits made just before unload, and leave the editor when its pro…
microbit-matt-hillsdon Nov 20, 2026
1cc7af3
Migrate a session storage project when the app starts (#1426)
microbit-matt-hillsdon Nov 20, 2026
886ad77
Let a project switch go ahead if MicroPython failed to load
microbit-robert Nov 20, 2026
5605ecd
Retry file system initialisation after every failure
microbit-matt-hillsdon Nov 20, 2026
ce2416c
Remove "back to main code" breadcrumb part
microbit-robert Nov 20, 2026
e9b08f7
Call #project: links project links, not migrations
microbit-matt-hillsdon Nov 20, 2026
04dd1f3
Drop a #project: link that cannot be read
microbit-matt-hillsdon Nov 20, 2026
f9099da
Shorten a comment
microbit-matt-hillsdon Nov 20, 2026
655a14c
Have the link parser say when a link is unreadable
microbit-matt-hillsdon Nov 20, 2026
08d1a9a
Ask whether a project link is pending, not what the address says
microbit-matt-hillsdon Nov 20, 2026
6460bf5
Bump theme to 0.5.0
microbit-matt-hillsdon Nov 20, 2026
b61798a
Describe pages, routing and project storage in the technical overview
microbit-matt-hillsdon Nov 20, 2026
b2da754
Note Safari's storage eviction and tie it to the projects tooltip
microbit-matt-hillsdon Nov 20, 2026
460e65f
Describe the close warning by what the user sees
microbit-matt-hillsdon Nov 20, 2026
5816383
Drop the storage persistence decision, keeping the limitation
microbit-matt-hillsdon Nov 20, 2026
df06f4a
Doc tweak
microbit-matt-hillsdon Nov 20, 2026
67ded27
Add a notice and dialog explaining that ideas are moving
microbit-robert Nov 20, 2026
d075fbd
Show the ideas notice only where there is a home page
microbit-matt-hillsdon Nov 20, 2026
cfb6102
Align the ideas notice's icon with its first line
microbit-matt-hillsdon Nov 20, 2026
bdeb1a3
Keep the open project's selection when another tab saves it
microbit-robert Nov 20, 2026
7f69fa7
Harden what happens when saving to the database fails
microbit-matt-hillsdon Nov 20, 2026
f69c13b
Move the close warning tests to the write errors block
microbit-matt-hillsdon Nov 20, 2026
163b33a
Keep a failed save's changes for the next flush
microbit-matt-hillsdon Nov 20, 2026
141d058
Close three gaps the retry queue opened
microbit-matt-hillsdon Nov 20, 2026
49af631
Save before reloading the open project, however it is asked for
microbit-matt-hillsdon Nov 20, 2026
9c6ba5e
Say all the ways a reload can be overtaken
microbit-matt-hillsdon Nov 20, 2026
a829321
Report where each tab keeps its project as a user property
microbit-matt-hillsdon Nov 20, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ env:
# renovate: datasource=npm depName=npm
NPM_VERSION: "11"
# renovate: datasource=npm depName=@microbit-foundation/python-editor-v3-microbit registryUrl=https://npm.pkg.github.com
THEME_VERSION: 0.4.1
THEME_VERSION: 0.5.0

jobs:
stages:
Expand Down
6 changes: 4 additions & 2 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,10 @@
This app uses react-aria-components + Panda CSS via `@microbit/ui`.
Read `../ui/docs/hints.md` before styling/theming/UI work.
The private theme package is the sibling repo
`../python-editor-v3-microbit` (consumed via a manual `node_modules`
symlink locally — re-create it after `npm install`).
`../python-editor-v3-microbit`. Link it with `npm run dev:link-theme`, which
builds it and symlinks it into `node_modules`; re-run after `npm install`.
Home page artwork (banner, help cards) lives there and is resolved per file by
`theme-package/images/*` imports, falling back to `src/deployment/default`.

`@microbit/ui` is consumed as the **published package**, pinned in
`package.json`. To develop against a local `../ui` checkout instead — what you
Expand Down
96 changes: 81 additions & 15 deletions docs/analytics-events.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,18 @@ at the end maps the previous UA-shaped events to their replacements.
Set once on app boot. Auto-attach to every subsequent event for the same user,
available as user-scoped breakdowns in GA4.

| Name | Values | Set when | Notes |
| ------------------ | ------------ | -------- | -------------------------------------------------------------- |
| `webusb_available` | `yes` / `no` | App boot | From `"usb" in navigator`. Same name and values as ml-trainer. |
| Name | Values | Set when | Notes |
| ------------------ | -------------------------------------------------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `webusb_available` | `yes` / `no` | App boot | From `"usb" in navigator`. Same name and values as ml-trainer. |
| `project_storage` | `database` / `session_no_indexeddb` / `session_open_failed` / `host` | App boot, once the projects database has opened or failed to | Where the tab keeps its project. `database` is IndexedDB. The two `session_` values are the session-storage fallback: the browser has no IndexedDB, or it has but the database would not open. `host` is iframe controller mode, where the embedding page keeps the project. |

Unlike ml-trainer there is no `webbluetooth_available`: the editor doesn't use
Bluetooth.

`project_storage` is there to show how many sessions really run without the
projects database, and why, which decides whether the session-storage fallback
is worth keeping.

## Device events

Same event family and params as ml-trainer so a cross-product device dashboard
Expand Down Expand Up @@ -108,26 +113,81 @@ No `destination` param: the editor only downloads. ml-trainer's
### `project_import`

User brought files in. Fires once per drop / picker selection, before the
files are parsed, so it counts attempts.

| Param | Values |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `source` | `drop` / `file_picker` (same values as ml-trainer) |
| `format` | `hex` (replaces the project) / `py` (Python file added to the project) / `other` (any other single file) / `multiple` (more than one file) |

### `project_reset`
files are parsed, so it counts attempts. A hex always becomes a new project.
Other files join the open project from the editor and become a new project
from the home and projects pages.

User chose Reset project, replacing everything with the starter program. Fires
when the menu action is chosen, before the confirm dialog. No params.
| Param | Values |
| --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `source` | `drop` / `file_picker` (same values as ml-trainer) |
| `format` | `hex` / `py` (a single Python file) / `other` (any other single file) / `multiple` (more than one file) |
| `surface` | `editor` (the Files tab or a drop on the editor) / `home` (the projects row's Import button or a drop on the home page) / `projects` (a drop on the projects page) |

### `project_rename`

User set the project name, from the header or the name-your-project prompt on
save. No params.
save, with no params; or from a project card or the projects toolbar, with
`surface`.

| Param | Values |
| --------- | --------------------------------------------------------- |
| `surface` | `home` / `projects` (absent when renamed from the editor) |

## Project management events

The home and projects pages, aligned with ml-trainer's events of the same
names so one set of custom definitions serves both.

### `project_create`

User named and created a new project from the home page.

| Param | Values |
| --------- | ------ |
| `surface` | `home` |

### `project_open`

User opened a project from a card or its menu.

| Param | Values |
| --------- | ------------------- |
| `surface` | `home` / `projects` |

### `project_duplicate`

| Param | Values |
| --------- | ------------------- |
| `surface` | `home` / `projects` |

### `project_delete`

Fires once for a single delete and once for a multi-select delete, after the
user confirms.

| Param | Values |
| --------- | --------------------------------------------------------- |
| `count` | int (1 for a card's menu; the selection's size otherwise) |
| `surface` | `home` / `projects` |

### `project_search`

Projects page only. Fires once per intentional search, 400ms after the last
keystroke, not per keypress. No params.

### `project_sort`

Projects page only. Fires when the user changes the sort field or direction.

| Param | Values |
| ----------- | ---------------------------------------------- |
| `field` | `name` / `timestamp` (last modified or opened) |
| `direction` | `asc` / `desc` |

### `idea_open`

User opened an idea into the editor.
User opened an idea as a new project, from the home page idea dialog or the
editor's Ideas tab.

| Param | Values |
| ----- | -------------------------- |
Expand Down Expand Up @@ -166,6 +226,11 @@ Fires once per search session: when results first appear after typing, not
per keystroke (300ms debounce) and not again until results are cleared. No
params. Search terms are deliberately not sent.

### `ideas_notice_open`

User opened the dialog, from the notice in the Ideas tab, that explains that
ideas are moving to the home page. No params.

## Code snippet events

Moving code from the documentation into the editor. Drag and copy are the
Expand Down Expand Up @@ -234,6 +299,7 @@ reading old dashboards.

| Old name | Status |
| -------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `project_reset` | Removed with the Reset project action (September 2026); replacing a program means importing from the home page. |
| `boot` → `WebUSB-available` | Dropped. Replaced by the `webusb_available` user property. `session_start` auto-fires. |
| `connect` | Replaced by `device_step` (`task: connect`) and `device_success` / `device_failure` / `device_exit`. |
| `disconnect` | Renamed `device_disconnect`; widened with `reason` to also capture unexpected drops. |
Expand Down
Loading