Print Flow

About

Print Flow is a 3D print queue management system that allows users to submit print requests, track their status, and enables administrators to manage the print queue. Built with a modern monorepo architecture using Bun, React 19, and SQLite.

Environments

Dev: https://print.dev.ejoneid.dev
Demo: https://print.demo.ejoneid.dev (Let's anyone test the full app without logging in. Mock data. Environment is reset every deployment)
Prod: https://print.ejoneid.dev

Architecture

graph LR
    subgraph Client["Browser"]
        FE["Frontend"]
    end

    subgraph Services["Backend Services"]
        BE["Backend API"]
        AUTH["Auth Service"]
        ST["SuperTokens Core"]
    end

    subgraph External["External Services"]
        GOOGLE["Google OAuth"]
        PRINTABLES["Printables"]
        MAKERWORLD["MakerWorld"]
    end

    subgraph Storage["Storage"]
        DB[("SQLite")]
        S3[("S3")]
    end

    subgraph HomeNetwork["Home Network (isolated)"]
        PrintCore["PrintCore API"]
        BAMBU["Bambulabs P1S"]
    end

    FE -- "/api/*" --> BE
    FE -- "/auth/*" --> AUTH

    BE -- "validate JWT" --> ST
    BE --> DB
    BE --> S3
    FE -- "presigned URLs" --> S3
    PrintCore -- "REST over SSH tunnel" --> BE
    BE -- "scrape model images" --> PRINTABLES
    BE -- "scrape model images" --> MAKERWORLD

    AUTH --> ST
    AUTH --> GOOGLE

    PrintCore -- "MQTT" --> BAMBU

Loading

⚠️ Requirements

• Bun (v1.3.0 or higher)

🚀 Getting Started

1. Clone the repository
2. Create .env files. Each service requires its own '.env' file with environment variables. See the example.env files in each service for an example. To copy the example files, run the following command:

cp backend/example.env backend/.env &&
cp frontend/example.env frontend/.env &&
cp auth/example.env auth/.env

3. Install dependencies

bun install

4. Start the backend and frontend simultaneously in development mode

bun dev