ziro-designer

KO | EN

gitlite — search

#computer-vision #list #api #java #containers #gemini #monitoring #redis #cloud-native #svg

(★ 9)

No description available.

File Explorer

ZIP Download

Showing a partial file list — download the zip above to see everything.

- - ci.yml
- - array_options.ts
  - color4d.ts
  - common.ts
  - cross_probing_settings.ts
  - dsnlexer.ts
  - eda_draw_frame.ts
  - eda_pattern_match.ts
  - eda_shape.ts
  - eda_text.ts
  - eda_units.ts
  - gal_pixel_grid.ts
  - generator.ts
  - index.ts
  - item_realignment.ts
  - kiid.ts
  - page_info.ts
  - pin_numbers.ts
  - pin_type.ts
  - png_meta.ts
  - reference_image.ts
  - render_settings.ts
  - reporter.ts
  - richio.ts
  - string_utils.ts
  - stroke_params.ts
  - table.ts
  - text_vars.ts
  - transform.ts
- package.json
- tsconfig.json
- - favicon.svg
  - logo-email.png
  - robots.txt
  - sitemap.xml
- - inline-calc.mjs
  - vendor-cursors.mjs
  - vendor-lib-table-descr.mjs
- - App.tsx
  - browser_support.ts
  - calc-standalone.tsx
  - libraryBundleStore.ts
  - libraryHosts.ts
  - libraryPreload.ts
  - main.tsx
  - occt-import-js.d.ts
  - vite-env.d.ts
- - manifest.sql
  - projects.sql
  - storage.sql
  - user_settings.sql
- .env.example
- .env.production
- calc-standalone.html
- index.html
- package.json
- tsconfig.hkcycle-mutants.json
- tsconfig.json
- vite.calc.config.ts
- vite.config.ts
- vitest.config.ts
- - config.mts
- - confirm-signup.html
- - file-dialog.md
- - logo.svg
- - 2026-09-12-kaminaris-sync-branch.md
- CLAUDE.md
- editor-status.md
- encryption-design.md
- encryption-plan.md
- frame-titles.md
- index.md
- kicad-global-vs-local.md
- live-board-stage0.md
- package.json
- security.md
- vercel.json
- - fieldbox.ts
  - index.ts
  - lib_symbol.ts
  - lib_symbol_compare.ts
  - pin_box.ts
  - pin_type.ts
  - project.ts
  - sch_field.ts
  - sch_pin.ts
  - types.ts
- package.json
- tsconfig.json
- - aperture_macro.ts
  - dcode.ts
  - excellon.ts
  - file_detect.ts
  - gbr_layout.ts
  - gerber_draw_item.ts
  - gerber_file_image.ts
  - gerber_file_image_parse.ts
  - index.ts
  - layer_sort.ts
  - read_gerber.ts
  - types.ts
- package.json
- tsconfig.json
- - package.json
  - tsconfig.json
- - package.json
  - tsconfig.json
- - LICENSE
  - package.json
  - tsconfig.json
- - package.json
  - tsconfig.json
- - board_classes_values.ts
  - cable_size.ts
  - color_code.ts
  - common_data.ts
  - electrical_spacing_values.ts
  - eseries.ts
  - format.ts
  - fusing_current.ts
  - galvanic_corrosion.ts
  - iec60664.ts
  - iec60664_tables.ts
  - index.ts
  - regulator_datafile.ts
  - regulators_funct.ts
  - resistor_substitution_utils.ts
  - tracks_width_versus_current_formula.ts
  - via_size.ts
  - wavelength.ts
- package.json
- tsconfig.json
- - autoplace_footprints.ts
  - autoplace_matrix.ts
  - barcode_geometry.ts
  - barcode_properties.ts
  - bezier_tool.ts
  - board.ts
  - board_connected_item.ts
  - board_design_settings_sizes.ts
  - board_exchange_footprint.ts
  - board_file_model.ts
  - board_item.ts
  - board_reannotate.ts
  - board_stackup_distance.ts
  - board_statistics.ts
  - cleanup_connectivity.ts
  - cleanup_item.ts
  - connectivity.ts
  - convert_basic_shapes_to_polygon.ts
  - convert_lines.ts
  - convert_shape_list_to_polygon.ts
  - convert_shapes.ts
  - courtyard.ts
  - courtyard_collision.ts
  - create_array.ts
  - cross_probe.ts
  - diff_footprint.ts
  - dimension_geometry.ts
  - dimension_properties.ts
  - dimension_text.ts
  - distribute_items.ts
  - draw_dimension.ts
  - draw_table.ts
  - draw_textbox.ts
  - eda_text_format.ts
  - edit-board.ts
  - edit-footprint.ts
  - export_d356.ts
  - filter_selection.ts
  - find_by_query.ts
  - footprint.ts
  - footprint_checker.ts
  - footprint_diff.ts
  - footprint_library.ts
  - footprint_properties.ts
  - footprint_utils.ts
  - fp_lib_table.ts
  - global_deletion.ts
  - global_edit_text_and_graphics.ts
  - global_edit_tracks_and_vias.ts
  - graphic_properties.ts
  - graphics_cleaner.ts
  - graphics_importer_pcbnew.ts
  - image_geometry.ts
  - image_properties.ts
  - index.ts
  - inherit_track_width.ts
  - item_description.ts
  - layer_ids.ts
  - local_ratsnest.ts
  - lset.ts
  - modify_lines.ts
  - move_exact.ts
  - msg_panel.ts
  - net_inspector.ts
  - netinfo.ts
  - non_copper_zone_properties.ts
  - outset_items.ts
  - pad.ts
  - pad_enumerate.ts
  - pad_margins.ts
  - pad_properties.ts
  - padstack.ts
  - padstack_drill.ts
  - pcb_clipboard.ts
  - pcb_cursor_snap.ts
  - pcb_field.ts
  - pcb_grid_helper.ts
  - pcb_selection_conditions.ts
  - pcb_shape.ts
  - pcb_text.ts
  - pcb_text_help.ts
  - pcb_track.ts
  - place_file_exporter.ts
  - place_image.ts
  - plot_dxf.ts
  - plot_gerber.ts
  - plot_pdf.ts
  - plot_png.ts
  - plot_ps.ts
  - plot_svg.ts
  - png_encoder.ts
  - point_editor.ts
  - polygon_booleans.ts
  - position_relative.ts
  - properties_panel.ts
  - ratsnest.ts
  - read-board.ts
  - rule_area_properties.ts
  - shape_fill.ts
  - spread_footprints.ts
  - swap_layers.ts
  - table_geometry.ts
  - table_properties.ts
  - teardrop.ts
  - teardrop_global_edit.ts
  - text_geometry.ts
  - text_metrics.ts
  - text_to_polyset.ts
  - textbox_geometry.ts
  - textbox_properties.ts
  - track_via_properties.ts
  - tracks_cleaner.ts
  - transform_shape_to_polygon.ts
  - types.ts
  - unused_pad_layers.ts
  - via_layers.ts
  - via_placer.ts
  - write-board.ts
  - write-footprint.ts
  - zone.ts
  - zone_connection.ts
  - zone_filler.ts
  - zone_islands.ts
  - zone_properties.ts
- package.json
- tsconfig.json
- - A4_ISO5457-1999_ISO7200-2004_EN.kicad_wks
  - basic_ellipses.dxf
  - C.kicad_sym
  - complex_hierarchy.kicad_sch
  - custom_pads_1pin.kicad_mod
  - design_inspector_xpm.txt
  - GND.kicad_sym
  - interf_u.cmp
  - interf_u.net
  - issue22127_fusion360_splines.dxf
  - kicad-saved_A4_ISO5457-1999_ISO7200-2004_EN.kicad_wks
  - kicad-saved_pagelayout_default.kicad_wks
  - nfc-antenna.kicad_sch
  - pagelayout_default.kicad_wks
  - pagelayout_logo.kicad_wks
  - R.kicad_sym
  - schematic.keywords
  - zint_reedsol_logs.json
  - zint_vectors.json
- - barcode_mutants.py
  - symprops_layout.md
- - big_board.ts
  - chooser.bench.ts
  - kicad_sexpr_board_diff.ts
  - kicad_sexpr_header_diff.ts
  - parse_all.bench.ts
  - parse_memory.ts
  - preload_after.bench.ts
  - prettify_corpus.ts
  - README.md
  - relay.bench.ts
  - resave_diff.ts
  - rows.bench.tsx
  - scoring_ab.bench.ts
  - vitest.bench.config.ts
  - zone_triangulation.ts
- - .gitignore
  - afterlast_probe.cpp
  - appearance_row_probe
  - appearance_row_probe.cpp
  - aui_dock_pos_probe
  - aui_dock_pos_probe.cpp
  - aui_overflow_probe
  - aui_overflow_probe.cpp
  - aui_sash_probe
  - aui_sash_probe.cpp
  - calculator_108_mutants.py
  - calculator_e2e_mutants.py
  - change_symbols_probe
  - change_symbols_probe.cpp
  - checkbox_probe
  - checkbox_probe.cpp
  - chooser_cells_probe.cpp
  - chooser_shell_probe
  - chooser_shell_probe.cpp
  - constraints_layout_probe
  - constraints_layout_probe.cpp
  - cvpcb_listbox_probe
  - cvpcb_listbox_probe.cpp
  - dialog_chrome_probe
  - dialog_chrome_probe.cpp
  - dialog_control_state_mutants.py
  - display_netnames_probe.cpp
  - editor_open_timeline.mjs
  - entry_probe.cpp
  - eseries_grid_probe
  - eseries_grid_probe.cpp
  - field_props_width_probe
  - field_props_width_probe.cpp
  - fields_grid_probe
  - fields_grid_probe.cpp
  - fp_libtree_mutants.py
  - fpedit_mutants.py
  - gerber_sort_invert
  - gerber_sort_invert.cpp
  - gerber_sort_probe
  - gerber_sort_probe.cpp
  - gerbview_toolbar_probe
  - gerbview_toolbar_probe.cpp
  - grid_edit_fill_probe
  - grid_edit_fill_probe.cpp
  - grid_edit_selection_probe
  - grid_edit_selection_probe.cpp
  - hierarchy_tree_probe.cpp
  - kidialog_probe
  - kidialog_probe.cpp
  - launchers_timeline.mjs
  - layer_panel_colour_probe
  - layer_panel_colour_probe.cpp
  - library_preload_mutants.py
  - libtree_details_probe
  - libtree_details_probe.cpp
  - libtree_rowheight_probe
  - libtree_rowheight_probe.cpp
  - libtree_selection_probe
  - libtree_selection_probe.cpp
  - maybe_absent_bool_mutants.py
  - memory_infra.mjs
  - memory_timeline.mjs
  - mouse_panel_probe
  - mouse_panel_probe.cpp
  - msgpanel_probe
  - msgpanel_probe.cpp
  - page_settings_mutants.py
  - pcb_hmr_probe.mjs
  - pl_editor_settings_mutants.py
  - prefs_ui_group_probe
  - prefs_ui_group_probe.cpp
  - profile_editor_open.mjs
  - progress_dialog_probe.py
  - propgrid_probe
  - propgrid_probe.cpp
  - props_panel_mutants.py
  - README.md
  - reopen_timeline.mjs
  - savedlg_probe
  - savedlg_probe.cpp
  - selfilter_grid_probe
  - selfilter_grid_probe.cpp
  - serve_spa.mjs
  - slider_probe
  - slider_probe.cpp
  - spacemouse_panel_probe
  - spacemouse_panel_probe.cpp
  - spin_ctrl_probe.py
  - stc_bestsize_probe
  - stc_bestsize_probe.cpp
  - stock_cursor_probe.py
  - stripline_oracle
  - stripline_oracle.cpp
  - swatch_probe
  - swatch_probe.cpp
  - symprops_row_probe
  - symprops_row_probe.cpp
  - syscolour_probe
  - syscolour_probe.cpp
  - tlw_setsize_probe.cpp
  - toolbar_checked_probe
  - toolbar_checked_probe.cpp
  - toolbar_customization_probe.cpp
  - tracks_vias_grid_probe
  - tracks_vias_grid_probe.cpp
  - vtoolbar_probe
  - vtoolbar_probe.cpp
  - wxsplit_probe.cpp
- package.json
- tsconfig.json
.env.example
.gitignore
biome.json
CLAUDE.md
LICENSE
NOTICE.md
package.json
PHILOSOPHY.md
pnpm-lock.yaml
pnpm-workspace.yaml
README.md
STRUCTURE.md

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Showing a partial file list.

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**Professional electronics design in a browser tab: zero learning curve, zero
installs.**

**ZiroEDA** is a browser-native, open-source electronics design suite. It speaks the industry's open file formats
natively: projects made in KiCad open directly with no import step, no
migration, no retraining, while everything about the product (cloud projects,
sharing, and the AI-assisted design tools on our roadmap) is built web-first.

The core is free software (GPL-3.0-or-later). The plan is to charge only for
what a hosted service uniquely adds on top: cloud compute (simulation,
autorouting, batch DRC), real-time team collaboration, and AI assistance,
never for the editor itself. See **[PHILOSOPHY.md](./PHILOSOPHY.md)** for our
format-compatibility promise and how we relate to the upstream ecosystem.

> ZiroEDA is an independent project. It is **not** affiliated
> with or endorsed by the KiCad project; "KiCad" is a trademark of its
> respective owners.

## Goals

- **Familiar.** Behave like the tools electronics engineers already know:
  same conventions, same hotkeys, same visual language, so switching costs
  nothing.
- **Interoperable.** Open formats are the source of truth. Your designs are
  plain files you own, readable by other tools, forever.
- **Web-native.** TypeScript + Canvas/WebGL in the browser. Heavy batch compute
  (simulation, 3D kernel ops, autorouting) offloads to a server when needed.
- **Expandable.** A shared engine underpins every editor (schematic, symbol,
  board, footprint today), so capabilities compound rather than being rebuilt
  per tool, and the coming AI copilot plugs into all of them at once.

## License

GPL-3.0-or-later. See [LICENSE](./LICENSE).

This project reuses a substantial amount of KiCad's work: much of the engine is
a TypeScript port of KiCad's C++, the icons are KiCad's, and the symbol,
footprint and 3D model libraries are KiCad's official libraries. Those carry two
different licences, GPL for the code and icons and CC-BY-SA 4.0 with the KiCad
library exception for the libraries. See [NOTICE](./NOTICE.md) for the full
attribution.

## Tech stack

| Concern                | Choice                                             |
| ---------------------- | -------------------------------------------------- |
| Core language          | TypeScript (Rust/WASM reserved for measured hot paths) |
| UI                     | React                                              |
| 2D rendering           | Canvas2D → WebGL behind an interface               |
| 3D viewer              | three.js                                           |
| State / undo / actions | command bus with lossless document sources         |
| Auth / cloud sync      | Supabase                                           |
| Crash reporting        | Sentry (opt-out, scrubbed)                         |
| Build / monorepo       | Vite + pnpm workspaces                             |
| Tests                  | Vitest                                             |

## Configuration

Every integration is env-gated and degrades to a fully offline app when its
variables are absent, so a clone runs with no configuration at all.

| Variable                       | Effect when unset                        |
| ------------------------------ | ---------------------------------------- |
| `VITE_SUPABASE_URL`            | Auth and cloud sync disabled             |
| `VITE_SUPABASE_ANON_KEY`       | Auth and cloud sync disabled             |
| `VITE_SUPABASE_STORAGE_BUCKET` | Cloud file storage disabled              |
| `VITE_SENTRY_DSN`              | Crash reporting disabled                 |
| `VITE_RELEASE`                 | Falls back to the build's git SHA        |
| `SENTRY_ORG`                   | Source maps not uploaded (set in `vercel.json`) |
| `SENTRY_PROJECT`               | Source maps not uploaded (set in `vercel.json`) |
| `SENTRY_AUTH_TOKEN`            | Source maps not uploaded (secret, dashboard only) |
| `SENTRY_URL`                   | Defaults to `https://de.sentry.io/`      |

### Cloud sync

Run `supabase/projects.sql`, `supabase/storage.sql` and `supabase/manifest.sql`
once each in the Supabase SQL editor, and turn on **object versioning** for the
bucket. The app works without any of it — everything is local-first — but a
deployment that syncs should have all four.

Project files are stored **content-addressed**: a blob's key is the SHA-256 of
its bytes, at `<userId>/blobs/<hash>`. Three properties follow, and they are the
whole design:

- **A write cannot destroy.** Different contents cannot share a key, so an
  upload only ever adds. Keying blobs by `<project>/<filename>` instead — which
  is what the first version did — makes every save an overwrite of the only
  copy.
- **A read is verifiable.** The key states what the bytes must hash to, so a
  truncated or substituted download is caught rather than handed to the parser.
- **History is nearly free.** Superseded blobs are still there under their own
  keys, so `project_versions` recording each committed manifest is enough to
  restore any earlier state.

The commit protocol is: store every blob, **confirm every blob is present**,
then write the row — and only then. Until that row lands the previous version is
entirely intact, so a push that fails at any point changes nothing. A row can
therefore never reference an object that is not in the store.

Reconciliation is last-write-wins on `updatedAt`, with the losing side kept as a
`(local copy, <date>)` project rather than discarded. A per-project failure is
reported in the UI, not logged to the console.

The transport is an interface (`cloud/backend.ts`) whose every method throws or
fulfils; `cloud/supabaseBackend.ts` is the only file that touches Supabase's
`{ data, error }` convention. That is deliberate. The convention's failure mode
is silent — `await` succeeds whether or not `error` is set — and the first
version, which called the client directly from the store and so could not be
reached by any test, lost the contents of eleven projects to exactly that.

### Crash reporting

Reports are **opt-out**: on by default, switched off under
Preferences → Common → Privacy. Payloads are scrubbed before sending
(`designer/src/telemetry/scrub.ts`): file names are redacted, URLs lose their
query strings, console breadcrumbs are dropped, and neither the signed-in
account nor an IP address is attached. Reports are grouped by a random
per-browser id that is not linked to the user's account.

Tracing, session replay and profiling are all disabled: this collects stack
traces to fix bugs, not usage analytics.

The deployed DSN lives in `vercel.json` rather than the Vercel dashboard. A
Sentry DSN is a public, write-only ingest key: it ships inside the client
bundle by design and can neither read issues nor reach the account, so keeping
it in the repo means every deploy and preview is configured identically, with
nothing to forget. Local development stays off unless you set `VITE_SENTRY_DSN`
yourself, so debugging never pollutes production issues.

The project is on Sentry's **EU (`de`) region**, which `vite.config.ts` already
defaults to. Note that an auth token must also be created on `de.sentry.io`:
tokens are region-scoped, and the CLI otherwise talks to the US instance and
uploads into a void.

#### Source maps

Without them every stack trace arrives minified (`index-a1b2c3.js:1:48291`),
which is close to useless. The org and project slugs are plain identifiers and
live in `vercel.json` with the DSN; `SENTRY_AUTH_TOKEN` is a real secret and
belongs in the Vercel dashboard only. Uploading starts as soon as all three are
present.

Because the slugs are committed, **renaming the Sentry project changes its slug
and silently stops symbolication**: the upload 401s, the build still succeeds,
and traces quietly go back to being minified. Rename in Sentry and here
together.

Maps are generated as `hidden` and **deleted after upload**: no
`sourceMappingURL` comment is emitted and no `.map` file is ever deployed, so
Sentry can symbolicate while the public site never serves our source. Deletion
happens even when the upload fails, so a bad token cannot leak source.

Upload failures are logged but **do not fail the build**, so an expired token
degrades symbolication instead of breaking a deploy. That means a silent
failure mode: if traces come back minified, check the build log rather than
assuming it is working.

Both the running app and the uploaded maps take their release from the same
value in `vite.config.ts` (Vercel's commit SHA, else the git SHA). They must
match exactly: Sentry binds events to maps by release name, and a mismatch
just silently leaves stacks minified.

## Repository layout

See **[STRUCTURE.md](./STRUCTURE.md)** for the full map and the conventions
behind it.

```
ziro-designer/
  designer/      # the app: launcher, editor frames, cloud sync, served libraries
  eeschema/      # schematic engine: document model, file io, connectivity/ERC, tools
  pcbnew/        # board engine: object model, file io, board editing
  common/        # shared EDA classes: shapes, text, units, transforms, stroke font
  libs/
    kimath/      # math: vectors, angles, trigonometry
    core/        # small shared utilities
    sexpr/       # lossless S-expression parser/serializer
  qa/            # unit tests (qa/unittests/<module>) + fixtures (qa/data)
```

### `@ziroeda/designer`: the app

A React + Canvas2D suite with four editors: schematic, symbol, board, and
footprint (plus a 3D board viewer), each wrapped in familiar window chrome:
menu bar, toolbars, panels, and a live status bar. Run it with:

```bash
pnpm -C designer dev      # http://localhost:5173
pnpm -C designer build    # typecheck + production build
```

### The engine packages

Two layers, both built for round-trip fidelity:

- **Lossless S-expression layer**: the parser/serializer for the open design
  formats. "Lossless" is a hard requirement: it preserves every node (including
  fields ZiroEDA does not yet model) and the exact source text of numeric
  atoms, so saving a file never silently corrupts data the user cares about.
  Correctness is enforced by round-trip tests against real design files
  (`parse ∘ serialize ∘ parse` is identity over the AST).

- **Typed document models**: typed views over that AST (symbols, pins, wires,
  labels, boards, footprints, pads, zones). Coordinates are integer internal
  units (100 nm), not float millimetres, so geometry and equality stay exact.
  Every modelled item keeps its source AST node, so unmodified items round-trip
  byte-for-byte.

```bash
pnpm install
pnpm -C qa test      # run all unit tests (parser round-trips, model, editing, ERC)
pnpm -r typecheck    # typecheck every package
```

## Roadmap

1. **Schematic capture**: lossless file io, typed model, faithful rendering,
   editing with undo/redo, symbol placement, save. ✅
2. **Connectivity + ERC**: net building, dangling detection, rule checks. ✅
3. **Board + footprint editing**: object model, file io, move/rotate/delete/
   duplicate, 3D viewer. ✅ (in progress: routing tools)
4. **Cloud projects**: auth, project storage, templates. ✅ (hardening)
5. **Quality pass**: CI, lint, bug inventory, launcher/editor cleanup. ⟵ *now*
6. **Collaboration**: sharing, review, multiplayer.
7. **AI copilot**: assisted placement/routing/review, growing into agentic
   design tools.

ziro-designer

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README