Skip to content

Proposal: OpenQR (open-source QR code generator) compose sample #825

Description

@sam-moreton

Proposal

What application? OpenQR — a free, open-source (AGPL-3.0) QR code generator built with Next.js. Codes are generated entirely client-side; the repo is a plain Next.js app that runs with no environment variables and no database.

Disclosure up front: I'm the author of the project.

Why it could be a useful sample: a growing class of self-hosted apps is "single stateless web service, prebuilt OCI image, no dependencies". Most samples here teach multi-service patterns; a minimal single-service sample (either pulling ghcr.io/open-qr/openqr or building from source with build: .) is the smallest possible working compose file, which has teaching value of its own for newcomers who just want something that runs.

Two possible shapes, happy to take direction on which is more valuable here:

  1. compose.yaml pulling the prebuilt GHCR image (3–4 lines, zero config, works on any host with Docker).
  2. compose.yaml with build: . against the repo's multi-stage Dockerfile (demonstrates build context + a Next.js production build).

If the maintainers feel a single-service sample is too thin for the list, no hard feelings — feel free to close. If there's interest, I'll send the PR with an example README per the contributing guide.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions