{"id":50575930,"url":"https://github.com/maxzz/trace-viewer-25-go","last_synced_at":"2026-06-04T22:01:42.588Z","repository":{"id":361743926,"uuid":"1255611374","full_name":"maxzz/trace-viewer-25-go","owner":"maxzz","description":"Diagnostic trace visualizer","archived":false,"fork":false,"pushed_at":"2026-06-01T03:50:19.000Z","size":9641,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-01T05:13:39.664Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/maxzz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-01T02:35:01.000Z","updated_at":"2026-06-01T03:50:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/maxzz/trace-viewer-25-go","commit_stats":null,"previous_names":["maxzz/trace-viewer-25-go"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/maxzz/trace-viewer-25-go","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxzz%2Ftrace-viewer-25-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxzz%2Ftrace-viewer-25-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxzz%2Ftrace-viewer-25-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxzz%2Ftrace-viewer-25-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/maxzz","download_url":"https://codeload.github.com/maxzz/trace-viewer-25-go/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/maxzz%2Ftrace-viewer-25-go/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33921352,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-04T22:01:41.485Z","updated_at":"2026-06-04T22:01:42.572Z","avatar_url":"https://github.com/maxzz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Trace Viewer 25 with Go/Wails Wrapper\n\nA high-performance diagnostic trace visualizer combining a modern, interactive React frontend (`trace-viewer-25`) with a native Go/Wails wrapper (`trace-viewer-25-go`) for OS-level integration and features.\n\n---\n\n## Table of Contents\n\n- [Project Structure](#project-structure)\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n- [Development and Debugging](#development-and-debugging)\n  - [Standalone Frontend (Web Browser)](#1-standalone-frontend-web-browser)\n  - [Full Go Wrapper Application](#2-full-go-wrapper-application)\n- [Building for Production](#building-for-production)\n  - [Standalone Frontend](#1-standalone-frontend)\n  - [Full Go Desktop Application](#2-full-go-desktop-application)\n- [Script Utilities](#script-utilities)\n- [Safe Mock Bindings (Browser Independence)](#safe-mock-bindings-browser-independence)\n\n---\n\n## Project Structure\n\n```text\ntrace-viewer-25-go/\n├── .gitignore\n├── package.json             # Root package script coordinator\n├── README.md                # This documentation\n├── frontend/                # Trace Viewer React application\n│   ├── src/\n│   │   ├── wailsjs/         # Generated Wails JS bindings (with browser-safe mocks)\n│   │   └── ...\n│   └── package.json\n├── wrapper/                 # Wails Go project application (backend)\n│   ├── main.go\n│   ├── app.go\n│   ├── wails.json           # Wails configuration\n│   └── frontend/\n│       └── dist/            # Assets folder copied from frontend/dist and embedded in Go\n└── scripts/                 # Consolidated build and helper utility scripts\n    ├── copy-dist.js         # Copies built assets from frontend to wrapper\n    ├── build.sh             # Builds the full application\n    ├── build-windows.sh     # Cross-compiles for Windows AMD64\n    └── ...\n```\n\n---\n\n## Prerequisites\n\nEnsure you have the following tools installed:\n\n* **Node.js** (v18+) \u0026 **pnpm** (v9+)\n* **Go** (v1.22+)\n* **Wails CLI** (v2+)\n  * Install via: `go install github.com/wailsapp/wails/v2/cmd/wails@latest` (or run `./scripts/install-wails-cli.sh`)\n\n---\n\n## Installation\n\nInstall all node dependencies for the root, frontend, and wrapper directories in one command:\n\n```bash\npnpm run install:all\n```\n\n---\n\n## Development and Debugging\n\n### 1. Standalone Frontend (Web Browser)\nTo run the React frontend alone in a local web browser with Hot Module Replacement (Vite):\n```bash\npnpm run dev\n```\nOpen [http://localhost:3000](http://localhost:3000) in your browser. Since safe JS/TS mock files are implemented, the application will not crash in standard browser environments.\n\n### 2. Full Go Wrapper Application\nTo run the complete application inside the native OS window with full Go integration and real-time backend updates:\n```bash\npnpm run dev:go\n```\n\n---\n\n## Building for Production\n\n### 1. Standalone Frontend\nBuilds the standalone React application to `frontend/dist/`:\n```bash\npnpm run build\n```\n\n### 2. Full Go Desktop Application\nTo build the fully native executable (this automatically builds the React frontend first, copies production assets into Go's embedding folder, and compiles the Go code):\n\n```bash\n# Build for your current platform\npnpm run build:go\n\n# Specifically cross-compile for Windows AMD64\npnpm run build:go:windows\n\n# Compile for all configured target platforms\npnpm run build:go:all\n```\n\nCompiled executables will be output to `wrapper/build/bin/`.\n\n---\n\n## Script Utilities\n\nAll scripts are located in the top-level `scripts/` directory:\n\n* `scripts/copy-dist.js`: Automatically called during the `postbuild` phase of the frontend to copy static assets into `wrapper/frontend/dist/` for embedding.\n* `scripts/build.sh`: Runs a default `wails build --clean` in the wrapper.\n* `scripts/build-windows.sh`: Builds for Windows AMD64.\n* `scripts/build-macos.sh`: Builds a macOS universal app.\n* `scripts/build-macos-intel.sh` / `scripts/build-macos-arm.sh`: Target specific Apple architectures.\n* `scripts/install-wails-cli.sh`: Installs or updates the Wails CLI command line tool.\n\n---\n\n## Safe Mock Bindings (Browser Independence)\n\nWails generates JavaScript bindings for Go functions on-demand. To ensure that importing these bindings in `frontend/` does not break the standalone browser development mode, the bindings inside `frontend/src/wailsjs/go/main/App.js` utilize runtime checks:\n\n```javascript\nexport function ToggleDevTools() {\n  if (window \u0026\u0026 window[\"go\"] \u0026\u0026 window[\"go\"][\"main\"] \u0026\u0026 window[\"go\"][\"main\"][\"App\"]) {\n    return window[\"go\"][\"main\"][\"App\"][\"ToggleDevTools\"]();\n  }\n  return Promise.resolve();\n}\n```\n\nThis guarantees seamless execution both as a browser tab and as a desktop wrapper!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxzz%2Ftrace-viewer-25-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmaxzz%2Ftrace-viewer-25-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmaxzz%2Ftrace-viewer-25-go/lists"}