Manufacturing Execution System (MES) for job shops and make-to-order manufacturers. Track jobs through production, give operators tablet-friendly work queues, and integrate with your ERP.
Live Demo · Documentation · GitHub
Current Release: 0.3.3
Job shops running high-mix, low-volume production — sheet metal, machine shops, custom fabrication. If you're tracking thousands of unique parts through multiple operations, this is built for you.
- Operator terminals — Touch-friendly tablets for starting/stopping jobs, viewing drawings, and logging time
- Work queues — Visual job lists organized by stage (cutting, bending, welding, etc.)
- Real-time tracking — Live status updates via WebSockets to dashboards and managers
- Job & part tracking — Follow orders through production with full visibility
- Dashboard stats — Active jobs, operator activity, and production metrics at a glance
- 3D STEP viewer — Browser-based CAD viewer for operators (no software install)
- REST API — Full CRUD for jobs, parts, operations with webhook notifications
- CSV import/export — Bulk data operations for ERP sync
- Multi-tenant SaaS — Row-level security for hosted deployments
- Multi-language — English, Dutch, German
- Self-hostable — Run on your own infrastructure
- API-first — Build custom integrations and own your data
See website/src/content/docs/guides/deployment.md for deployment instructions and website/src/content/docs/guides/self-hosting.md for the full self-hosting walkthrough.
Eryxon Flow uses a simple SemVer-based release model:
MAJORfor breaking API, database, or deployment changesMINORfor backward-compatible features and meaningful platform expansionsPATCHfor fixes, security hardening, docs, and release stabilization
Work in progress should land in the release notes and changelog pages under website/src/content/docs/guides/ until tagged.
- Supabase account
- Cloudflare account
- Node.js 20+
git clone https://github.com/SheetMetalConnect/eryxon-flow.git
cd eryxon-flow
cp .env.example .env
# Edit .env with your Supabase credentials
npm install
npm run devThis repository carries agent setup notes for the three CLI agents currently in use:
- Claude Code: install the
superpowersplugin and use the repo-local guide in .claude/INSTALL.md. The project enables it through .claude/settings.json. - Codex: install Superpowers once at the machine level and follow .codex/INSTALL.md. Codex discovers the shared skills from
~/.agents/skills/at startup. - Gemini CLI: install the
superpowersextension and use the project guidance in GEMINI.md.
The repository documents the setup, while the actual Claude/Codex/Gemini installs remain machine-level.
VITE_SUPABASE_URL
VITE_SUPABASE_PUBLISHABLE_KEY
VITE_SUPABASE_PROJECT_ID
See .env.example for complete list.
Frontend: React + TypeScript + Vite
UI: shadcn/ui + Tailwind CSS + Custom Design System
Backend: Supabase (PostgreSQL + Edge Functions + Realtime)
Deployment: Cloudflare Pages, Docker, or self-hosted reverse proxy setups
Database: Multi-tenant schema with RLS and versioned migrations under supabase/migrations/
API: Supabase Edge Functions with shared auth, validation, and webhook helpers
3D Rendering: Three.js with browser STEP parsing and optional backend-assisted CAD processing
- website/src/content/docs/ - Canonical documentation source
- website/src/content/docs/guides/changelog.md - Full release history
- website/src/content/docs/guides/releases.md - Versioning policy and current release summary
- website/src/content/docs/guides/deployment.md - Deployment guide
- website/src/content/docs/operations/security-audit-baseline.md - Security audit baseline and remediation tracking
- website/src/content/docs/api/rest-api-reference.md - Backend API reference
- website/src/content/docs/api/payload-reference.md - API payload shapes and examples
- website/src/content/docs/guides/self-hosting.md - Canonical self-hosting guide
- website/src/content/docs/architecture/app-architecture.md - Architecture overview
Business Source License 1.1
- Free to use for your own manufacturing business
- Source available for modification and improvement
- Self-host unlimited instances
- Cannot offer as competing hosted service
See LICENSE for full terms.
Change Date: 2029-01-01 (converts to Apache 2.0)
Why BSL? Free for your business, prevents competitors from reselling our hosted service. Converts to Apache 2.0 on 2029-01-01. Learn more about BSL.
- Documentation: website/src/content/docs/
- Issues: GitHub Issues
- Commercial support: office@sheetmetalconnect.com