https://github.com/sheetmetalconnect/eryxon-flow
Manufacturing Execution System (MES) for job shops and make-to-order manufacturers.
https://github.com/sheetmetalconnect/eryxon-flow
job-shops manufacturing mes metalworking operations react supabase
Last synced: about 1 month ago
JSON representation
Manufacturing Execution System (MES) for job shops and make-to-order manufacturers.
- Host: GitHub
- URL: https://github.com/sheetmetalconnect/eryxon-flow
- Owner: SheetMetalConnect
- License: other
- Created: 2025-11-10T12:51:12.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-05-01T20:31:03.000Z (about 1 month ago)
- Last Synced: 2026-05-01T22:11:35.568Z (about 1 month ago)
- Topics: job-shops, manufacturing, mes, metalworking, operations, react, supabase
- Language: TypeScript
- Homepage: https://eryxon.eu
- Size: 15.3 MB
- Stars: 3
- Watchers: 0
- Forks: 2
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Agents: AGENTS.md
Awesome Lists containing this project
README
Self-hosted Planning & Shop Floor Execution for Job Shops
Hosted Version ·
Docs ·
Issues
---
> **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).
Track 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.
Built 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.
## Features
**Shop Floor**
- Touch-friendly operator terminals (tablets, kiosks)
- Kanban work queues organized by production cell
- Real-time tracking via WebSockets
- Time tracking with one-tap clock in/out
**Management**
- Job and part tracking with full production visibility
- 3D STEP viewer — browser-based CAD, no software install
- QRM dashboard with WIP limits and capacity overview
- Issue tracking and quality management (NCR)
**Integration**
- REST API with 30+ endpoints (jobs, parts, operations, time entries, webhooks)
- Planning adapters (FrePPLe, Odoo MRP) for scheduling integration
- ERP sync with incremental change detection
- MQTT connectivity with retry, circuit breaker, dead letter queue
- Webhook notifications for lifecycle events
- MCP server for AI assistant integration
**Platform**
- Multi-language (English, Dutch, German)
- Multi-tenant SaaS with row-level security
- Self-hostable via Docker Compose
- BSL 1.1 license (free for your business, converts to Apache 2.0 after the BSL change date)
## Quick Start
```bash
git clone https://github.com/SheetMetalConnect/eryxon-flow.git
cd eryxon-flow
cp .env.example .env # Add your Supabase credentials
npm install
npm run dev # http://localhost:8080
```
Requires: Node.js 20+, [Supabase](https://supabase.com) project
## Architecture
```
React 18 + Vite + Tailwind + shadcn/ui
|
Supabase Client
|
PostgreSQL + Auth + RLS + Realtime + Storage
|
Edge Functions (Deno) ── 30+ REST API endpoints
|
Webhooks + MQTT + MCP Server
```
| Layer | Tech |
|-------|------|
| Frontend | React 18, TypeScript, Vite, Tailwind CSS, shadcn/ui |
| Backend | Supabase (PostgreSQL 17, Edge Functions, Realtime) |
| 3D Viewer | Three.js with browser-side STEP parsing |
| Deployment | Vercel (frontend), Supabase (backend), Docker (self-hosted) |
| API | REST with API key auth, rate limiting, webhook dispatch |
## Self-Hosting
Full self-hosting guide: [eryxon.eu/guides/self-hosting](https://eryxon.eu/guides/self-hosting/)
```bash
docker compose up -d
```
## API
30+ REST endpoints with filtering, pagination, search, and webhook notifications.
```bash
# List jobs
curl https://your-project.supabase.co/functions/v1/api-jobs \
-H "Authorization: Bearer ery_live_your_api_key"
# Create a job with nested parts and operations
curl -X POST https://your-project.supabase.co/functions/v1/api-jobs \
-H "Authorization: Bearer ery_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{"job_number":"WO-001","customer":"Acme","parts":[...]}'
```
Full API reference: [eryxon.eu/api/rest-api-reference](https://eryxon.eu/api/rest-api-reference/)
## Documentation
Full docs at **[eryxon.eu](https://eryxon.eu)** — run locally with `cd website && npm run dev`.
| Section | Link |
|---------|------|
| Introduction | [eryxon.eu/introduction](https://eryxon.eu/introduction/) |
| Quick Start | [eryxon.eu/guides/quick-start](https://eryxon.eu/guides/quick-start/) |
| Architecture | [eryxon.eu/architecture/app-architecture](https://eryxon.eu/architecture/app-architecture/) |
| REST API Reference | [eryxon.eu/api/rest-api-reference](https://eryxon.eu/api/rest-api-reference/) |
| MCP Server | [eryxon.eu/api/mcp-server-reference](https://eryxon.eu/api/mcp-server-reference/) |
| Deployment | [eryxon.eu/guides/deployment](https://eryxon.eu/guides/deployment/) |
| Self Hosting | [eryxon.eu/guides/self-hosting](https://eryxon.eu/guides/self-hosting/) |
| Operator Manual | [eryxon.eu/guides/operator-manual](https://eryxon.eu/guides/operator-manual/) |
| Changelog | [eryxon.eu/guides/changelog](https://eryxon.eu/guides/changelog/) |
## AI Agent Support
This repo is optimized for AI coding assistants:
| Tool | Config File |
|------|-------------|
| Claude Code | [CLAUDE.md](CLAUDE.md) |
| GitHub Copilot | [.github/copilot-instructions.md](.github/copilot-instructions.md) |
| Cursor | [.cursorrules](.cursorrules) |
| Gemini | [GEMINI.md](GEMINI.md) |
| Codex / Windsurf / Cline | [AGENTS.md](AGENTS.md) |
Specialized sub-agents in [.agents/](.agents/) for database, tech stack, and repo operations.
### Knowledge Graph (OpenTrace)
The 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.
```bash
pip install opentraceai # One-time install
opentraceai index . # Index the codebase (~3s)
opentraceai stats # View what's indexed
```
Claude Code commands: `/explore `, `/graph-status`, `/interrogate `. Agents: `@opentrace`, `@code-explorer`, `@dependency-analyzer`, `@find-usages`, `@explain-service`.
**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)
## License
**Business Source License 1.1**
- Free to use for your own manufacturing business
- Source available for modification and self-hosting
- Cannot offer as a competing hosted service
- Converts to **Apache 2.0** after the BSL change date
See [LICENSE](LICENSE) for full terms.
## Support
- Issues: [GitHub Issues](https://github.com/SheetMetalConnect/eryxon-flow/issues)
- Docs: [eryxon.eu](https://eryxon.eu)
- Professional services: [vanenkhuizen.com](https://www.vanenkhuizen.com/)
---
Made in Europe by Van Enkhuizen · Sheet Metal Connect