Is stewardpos still maintained?

Yes, active. Last change 4 days ago. Latest release v1.0.0, 3 months ago.

How widely used is stewardpos?

New, little track record. 0 stars, 1 year old. Look at the code and the owner before running it.

gitmanual

Reading the repo

Opening the box…

How to install stewardpos on macOS (24Skater/stewardpos) · gitmanual

How to install on macOS

24Skater/stewardpos

Steward · Register — open-source point of sale for churches and ministry-led retail. Self-hosted, Docker-ready.

Node.jsVite#church#churchtools#docker#nodejs

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Yes, activeLast change 4 days ago. Latest release v1.0.0, 3 months ago.
How widely used?: New, little track record0 stars, 1 year old. Look at the code and the owner before running it.

Difficulty: Moderate
Time: 30 min or more
Stars: ★ 0
Activity: Updated this month

Saved setup from 5 h ago

Will it work on macOS?

Yes, with Docker on macOS

It's a self-hosted app: the README runs it with Docker, and you open it in your browser.
On macOS that means installing Docker Desktop first.

Your system

macOS Windows Linux

Start here

Heads-upBuilding it yourself? It also needs PostgreSQL and 17 settings in .env (2 secret).

Run it with Docker

A self-hosted app: Docker runs it on your computer and you open it in the browser. Needs Docker Desktop (or Docker Engine on Linux). Run docker compose commands inside the cloned repo folder.

Choose one way. Most people should use the recommended one; the rest are other options.

Recommended: DockerNeeds Docker

docker compose up -d

Alternative: DockerNeeds Docker

docker compose -f docker-compose.demo.yml up -d

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 11 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

Parts list

1×Node.js 20runtime
1×Docker tool
1×pnpm package manager
1×PostgreSQL service

17× settings in .env

VITE_API_BASE_URLoptional
DOMAIN
ACME_EMAIL
JWT_SECRETsecret
POSTGRES_PASSWORDsecret
S3_ACCESS_KEY_IDsecretoptional
S3_SECRET_ACCESS_KEYsecretoptional
POSTGRES_DB
POSTGRES_USER
STORAGE_ADAPTER
S3_BUCKET
JWT_EXPIRES_IN
LOG_LEVEL
RATE_LIMIT_WINDOW_MS
RATE_LIMIT_MAX_REQUESTS
RATE_LIMIT_MAX_LOGIN_ATTEMPTS
EMAIL_ADAPTER

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/24Skater/stewardpos/badge.svg)](https://gitmanual.com/24Skater/stewardpos)

Good to know

Monorepo (workspaces) — install from the repo root.
Dockerfile available (base image: node:22-alpine).
Nested projects: backend/package.json

Details

License: MIT
Open issues: 7
Branch: main

package.json scripts (13)

devvite
buildvite build
build:devvite build --mode development
linteslint src/ e2e/
previewvite preview
testvitest
test:runvitest run
test:uivitest --ui
test:coveragevitest run --coverage
test:watchvitest --watch
typechecktsc -b --pretty false
test:e2eplaywright test
test:e2e:uiplaywright test --ui

Files we read (11)

.env.example

.env.prod.example

.github/workflows/ci.yml

.github/workflows/release-drafter.yml

.github/workflows/release.yml

CONTRIBUTING.md

Dockerfile

README.md

docker-compose.yml

package.json

pnpm-workspace.yaml

651 files in the repo

Contact

24Skater/stewardpos

Before you start

Your setup manual for stewardpos

What's inside

Handy for

Yes, with Docker on macOS

Start here

Run it with Docker

Did you get it running?

Still stuck? Get a written guide

Yes, with Docker on macOS

Start here

Run it with Docker

Did you get it running?

Still stuck? Get a written guide

More like stewardpos that run on macOS