{"id":49661267,"url":"https://github.com/sheetmetalconnect/eryxon-flow","last_synced_at":"2026-05-06T12:01:58.433Z","repository":{"id":333359455,"uuid":"1093489144","full_name":"SheetMetalConnect/eryxon-flow","owner":"SheetMetalConnect","description":"Manufacturing Execution System (MES) for job shops and make-to-order manufacturers.","archived":false,"fork":false,"pushed_at":"2026-05-01T20:31:03.000Z","size":16012,"stargazers_count":3,"open_issues_count":26,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T22:11:35.568Z","etag":null,"topics":["job-shops","manufacturing","mes","metalworking","operations","react","supabase"],"latest_commit_sha":null,"homepage":"https://eryxon.eu","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SheetMetalConnect.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-11-10T12:51:12.000Z","updated_at":"2026-05-01T21:55:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/SheetMetalConnect/eryxon-flow","commit_stats":null,"previous_names":["sheetmetalconnect/eryxon-flow"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/SheetMetalConnect/eryxon-flow","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SheetMetalConnect%2Feryxon-flow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SheetMetalConnect%2Feryxon-flow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SheetMetalConnect%2Feryxon-flow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SheetMetalConnect%2Feryxon-flow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SheetMetalConnect","download_url":"https://codeload.github.com/SheetMetalConnect/eryxon-flow/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SheetMetalConnect%2Feryxon-flow/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32692774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T08:33:17.875Z","status":"ssl_error","status_checked_at":"2026-05-06T08:33:17.221Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["job-shops","manufacturing","mes","metalworking","operations","react","supabase"],"created_at":"2026-05-06T12:01:56.270Z","updated_at":"2026-05-06T12:01:58.418Z","avatar_url":"https://github.com/SheetMetalConnect.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"public/logo-banner-dark.svg\" alt=\"Eryxon Flow\" width=\"400\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eSelf-hosted Planning \u0026 Shop Floor Execution for Job Shops\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://app.eryxon.eu\"\u003e\u003cstrong\u003eHosted Version\u003c/strong\u003e\u003c/a\u003e \u0026middot;\n  \u003ca href=\"https://eryxon.eu\"\u003eDocs\u003c/a\u003e \u0026middot;\n  \u003ca href=\"https://github.com/SheetMetalConnect/eryxon-flow/issues\"\u003eIssues\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/version-0.5.1-blue\" alt=\"Version\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/license-BSL--1.1-green\" alt=\"License\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/react-18-61DAFB?logo=react\" alt=\"React\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/supabase-backend-3FCF8E?logo=supabase\" alt=\"Supabase\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/typescript-strict-3178C6?logo=typescript\" alt=\"TypeScript\" /\u003e\n\u003c/p\u003e\n\n---\n\n\u003e **Project Status (May 2026):** Stable v0.5.1 maintenance hotfix. v0.5.0 remains the final active-development release; active development is currently on hold, and the hosted version at [app.eryxon.eu](https://app.eryxon.eu) remains online as-is. This is a self-hosted planning integration and shop floor execution tool; you are free to use, fork, and adapt it as you wish under the BSL 1.1 license terms. The code builds, tests pass, and Docker deployment works out of the box. Start with the [Architecture docs](docs/ARCHITECTURE.md) and the [Changelog](CHANGELOG.md).\n\nTrack jobs through production, give operators tablet-friendly work queues, view 3D CAD models in the browser, and integrate with your ERP/planning system — all from one self-hosted platform.\n\nBuilt for **high-mix, low-volume** production: sheet metal, machine shops, custom fabrication. If you're tracking thousands of unique parts through cutting, bending, welding, and assembly, this is for you.\n\n## Features\n\n**Shop Floor**\n- Touch-friendly operator terminals (tablets, kiosks)\n- Kanban work queues organized by production cell\n- Real-time tracking via WebSockets\n- Time tracking with one-tap clock in/out\n\n**Management**\n- Job and part tracking with full production visibility\n- 3D STEP viewer — browser-based CAD, no software install\n- QRM dashboard with WIP limits and capacity overview\n- Issue tracking and quality management (NCR)\n\n**Integration**\n- REST API with 30+ endpoints (jobs, parts, operations, time entries, webhooks)\n- Planning adapters (FrePPLe, Odoo MRP) for scheduling integration\n- ERP sync with incremental change detection\n- MQTT connectivity with retry, circuit breaker, dead letter queue\n- Webhook notifications for lifecycle events\n- MCP server for AI assistant integration\n\n**Platform**\n- Multi-language (English, Dutch, German)\n- Multi-tenant SaaS with row-level security\n- Self-hostable via Docker Compose\n- BSL 1.1 license (free for your business, converts to Apache 2.0 after the BSL change date)\n\n## Quick Start\n\n```bash\ngit clone https://github.com/SheetMetalConnect/eryxon-flow.git\ncd eryxon-flow\ncp .env.example .env    # Add your Supabase credentials\nnpm install\nnpm run dev             # http://localhost:8080\n```\n\nRequires: Node.js 20+, [Supabase](https://supabase.com) project\n\n## Architecture\n\n```\nReact 18 + Vite + Tailwind + shadcn/ui\n         |\n    Supabase Client\n         |\nPostgreSQL + Auth + RLS + Realtime + Storage\n         |\n    Edge Functions (Deno) ── 30+ REST API endpoints\n         |\n    Webhooks + MQTT + MCP Server\n```\n\n| Layer | Tech |\n|-------|------|\n| Frontend | React 18, TypeScript, Vite, Tailwind CSS, shadcn/ui |\n| Backend | Supabase (PostgreSQL 17, Edge Functions, Realtime) |\n| 3D Viewer | Three.js with browser-side STEP parsing |\n| Deployment | Vercel (frontend), Supabase (backend), Docker (self-hosted) |\n| API | REST with API key auth, rate limiting, webhook dispatch |\n\n## Self-Hosting\n\nFull self-hosting guide: [eryxon.eu/guides/self-hosting](https://eryxon.eu/guides/self-hosting/)\n\n```bash\ndocker compose up -d\n```\n\n## API\n\n30+ REST endpoints with filtering, pagination, search, and webhook notifications.\n\n```bash\n# List jobs\ncurl https://your-project.supabase.co/functions/v1/api-jobs \\\n  -H \"Authorization: Bearer ery_live_your_api_key\"\n\n# Create a job with nested parts and operations\ncurl -X POST https://your-project.supabase.co/functions/v1/api-jobs \\\n  -H \"Authorization: Bearer ery_live_your_api_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"job_number\":\"WO-001\",\"customer\":\"Acme\",\"parts\":[...]}'\n```\n\nFull API reference: [eryxon.eu/api/rest-api-reference](https://eryxon.eu/api/rest-api-reference/)\n\n## Documentation\n\nFull docs at **[eryxon.eu](https://eryxon.eu)** — run locally with `cd website \u0026\u0026 npm run dev`.\n\n| Section | Link |\n|---------|------|\n| Introduction | [eryxon.eu/introduction](https://eryxon.eu/introduction/) |\n| Quick Start | [eryxon.eu/guides/quick-start](https://eryxon.eu/guides/quick-start/) |\n| Architecture | [eryxon.eu/architecture/app-architecture](https://eryxon.eu/architecture/app-architecture/) |\n| REST API Reference | [eryxon.eu/api/rest-api-reference](https://eryxon.eu/api/rest-api-reference/) |\n| MCP Server | [eryxon.eu/api/mcp-server-reference](https://eryxon.eu/api/mcp-server-reference/) |\n| Deployment | [eryxon.eu/guides/deployment](https://eryxon.eu/guides/deployment/) |\n| Self Hosting | [eryxon.eu/guides/self-hosting](https://eryxon.eu/guides/self-hosting/) |\n| Operator Manual | [eryxon.eu/guides/operator-manual](https://eryxon.eu/guides/operator-manual/) |\n| Changelog | [eryxon.eu/guides/changelog](https://eryxon.eu/guides/changelog/) |\n\n## AI Agent Support\n\nThis repo is optimized for AI coding assistants:\n\n| Tool | Config File |\n|------|-------------|\n| Claude Code | [CLAUDE.md](CLAUDE.md) |\n| GitHub Copilot | [.github/copilot-instructions.md](.github/copilot-instructions.md) |\n| Cursor | [.cursorrules](.cursorrules) |\n| Gemini | [GEMINI.md](GEMINI.md) |\n| Codex / Windsurf / Cline | [AGENTS.md](AGENTS.md) |\n\nSpecialized sub-agents in [.agents/](.agents/) for database, tech stack, and repo operations.\n\n### Knowledge Graph (OpenTrace)\n\nThe codebase is indexed into a queryable knowledge graph via [OpenTrace](https://github.com/opentrace/opentrace). The current local index reports 1,019 functions, 45 classes, 822 files, 144 directories, 143 packages, and 3,341 graph edges for AI-assisted development.\n\n```bash\npip install opentraceai          # One-time install\nopentraceai index .              # Index the codebase (~3s)\nopentraceai stats                # View what's indexed\n```\n\nClaude Code commands: `/explore \u003cname\u003e`, `/graph-status`, `/interrogate \u003cquestion\u003e`. Agents: `@opentrace`, `@code-explorer`, `@dependency-analyzer`, `@find-usages`, `@explain-service`.\n\n**Developer docs** (in `docs/`): [Architecture](docs/ARCHITECTURE.md) | [API Catalog](docs/API_CATALOG.md) | [Routes](docs/ROUTE_MAP.md) | [Hooks](docs/HOOK_MAP.md) | [Conventions](docs/CONVENTIONS.md) | [Glossary](docs/GLOSSARY.md) | [Troubleshooting](docs/TROUBLESHOOTING.md) | [ADRs](docs/decisions/) | [MCP Setup](docs/AI_AGENT_SETUP.md)\n\n## License\n\n**Business Source License 1.1**\n\n- Free to use for your own manufacturing business\n- Source available for modification and self-hosting\n- Cannot offer as a competing hosted service\n- Converts to **Apache 2.0** after the BSL change date\n\nSee [LICENSE](LICENSE) for full terms.\n\n## Support\n\n- Issues: [GitHub Issues](https://github.com/SheetMetalConnect/eryxon-flow/issues)\n- Docs: [eryxon.eu](https://eryxon.eu)\n- Professional services: [vanenkhuizen.com](https://www.vanenkhuizen.com/)\n\n---\n\n\u003cp align=\"center\"\u003e\n  Made in Europe by \u003ca href=\"https://vanenkhuizen.com\"\u003eVan Enkhuizen\u003c/a\u003e \u0026middot; \u003ca href=\"https://sheetmetalconnect.com\"\u003eSheet Metal Connect\u003c/a\u003e\n\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsheetmetalconnect%2Feryxon-flow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsheetmetalconnect%2Feryxon-flow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsheetmetalconnect%2Feryxon-flow/lists"}