Appearance
Plans and billing
Plans are off unless you turn them on: a self-hosted install, by default, limits nothing and shows no pricing. Turn them on to run a service like crewhall.space.
Turning plans on
bash
CREWHALL_PLANS=onSpaces then have the limits of their plan (guide), Settings → Plan appears, and the welcome page and the app link to /pricing, which search engines may index.
Spaces that existed before plans were added are on Pro (people) and Team (organizations), free, until you change them; new ones start on Free. Change any space's plan from Platform → Accounts (a person) or Platform → Organizations: for friends, partners, or a support gesture. With plans on, moving a space down pauses its tasks beyond the limits.
Without Stripe, plans are only changed that way, and people are told plans aren't sold yet.
Selling them with Stripe
In Stripe, create two products, Pro and Team, each with a monthly and a yearly recurring price in euros (Team per unit: a seat). Copy the price ids.
Developers → Webhooks: an endpoint at
https://your-domain/api/hooks/stripe, with the eventscheckout.session.completed,customer.subscription.created,customer.subscription.updated,customer.subscription.deletedandinvoice.payment_failed. Copy its signing secret.Settings → Billing → Customer portal: allow updating payment methods and billing details, switching between your prices, cancelling (at the end of the period), and invoice history.
For VAT, turn on Stripe Tax and register where you collect it, then set
CREWHALL_STRIPE_TAX=on: checkout asks for the billing address and lets companies give a VAT number.In
.env:bashCREWHALL_STRIPE_SECRET_KEY=sk_live_... CREWHALL_STRIPE_WEBHOOK_SECRET=whsec_... CREWHALL_STRIPE_PRICE_PRO_MONTHLY=price_... CREWHALL_STRIPE_PRICE_PRO_YEARLY=price_... CREWHALL_STRIPE_PRICE_TEAM_MONTHLY=price_... CREWHALL_STRIPE_PRICE_TEAM_YEARLY=price_... CREWHALL_STRIPE_TAX=onThe monthly prices are required; without a yearly one, only monthly is offered. Try it all with Stripe's test keys (
sk_test_…) and test cards first.
Stripe is the source of truth: a subscription's status and price set the space's plan, a seat count follows an organization's members, and a cancelled or unpaid subscription puts the space back on Free. CrewHall refuses webhook calls whose signature doesn't match, or that are more than five minutes old.
