Free · MIT · v0.1.0
Hosts can run the entire platform themselves: branded sites, marketplace, calendars, bookings, iCal, and admin. No license fee. When we ship new features here, they land in this same codebase for you to pull in.
Free forever for self-hosting.You can still publish on the central Yall Come Back marketplace: register as free self-host (or paid), opt into marketplace, then either manage listings on this platform or push from a remote open-source deploy with a syndication API key (Admin → Brand & website). Platform website hosting (our servers, monthly fee) is optional. The software itself is MIT open source - reuse, modify, and run on your own domain at no cost.
This is the same stack powering the demo you're browsing. Point your domain at it when you're ready.
REPO_URL in src/lib/features.ts). Until then, use the local project folder or your private remote.STRIPE_ENABLED=false in .env. Manual deposits and hosting invoices work without Stripe. Keys and STRIPE_LIVE_READY are wired at go-live only.Clone or download the open-source repository (public git URL will be linked here at launch). Everything you see on the platform is in that codebase.
Run npm install, then npm run db:setup to create the database and demo data.
Copy .env.example → .env. Set AUTH_SECRET and DATABASE_URL. Leave Stripe off (STRIPE_ENABLED=false) until go-live - manual deposits and hosting invoices work without it.
npm run dev for local. For production: npm run build && npm start, or docker compose up.
Change site name, seed your host, add properties, connect iCal, and point your domain at the site.
# From the project root (public git URL added at launch) npm install cp .env.example .env # set AUTH_SECRET at minimum npm run db:setup npm run dev # Production npm run build && npm start # or: docker compose up
Full install notes live in the repository README.md. Feature inventory is maintained in src/lib/features.ts so this page stays accurate as the product grows.
Running your own copy does not automatically put stays on Find a Place. Marketplace is opt-in. Use one of the two technical paths below.
Path A · simpler
Listings live in the central database. You still pay $0 / month. Point your domain at Yall Come Back if you want a vanity URL.
No API key required. Best when you do not need a separate server or database.
Path B · remote open source
You run the MIT code on your own stack. You still create a free host account on Yall Come Back, then push listings with a syndication API key.
README.md).POST /api/syndication/listings with Authorization: Bearer ….Full field list, curl samples, unpublish, and troubleshooting: docs/remote-open-source-marketplace.md in the repo.
# On the central Yall Come Back site after approval:
# Admin → Brand & website → Generate syndication API key
export YCB_ORIGIN="https://yallcomeback.com" # or your platform origin
export YCB_SYNDICATION_KEY="ycb_syn_...." # shown once when generated
# Upsert a listing (same slug updates later)
curl -sS -X POST "$YCB_ORIGIN/api/syndication/listings" \
-H "Authorization: Bearer $YCB_SYNDICATION_KEY" \
-H "Content-Type: application/json" \
-d '{
"slug": "lake-cabin",
"title": "Lake cabin with dock",
"baseNightlyRate": 175,
"published": true,
"listOnMarketplace": true,
"city": "Malakoff",
"region": "TX",
"images": [
{ "url": "https://your-cdn.example.com/cover.jpg", "isCover": true }
]
}'
# List what the central site has for your brand
curl -sS "$YCB_ORIGIN/api/syndication/listings" \
-H "Authorization: Bearer $YCB_SYNDICATION_KEY"
# Unpublish from marketplace
curl -sS -X DELETE "$YCB_ORIGIN/api/syndication/listings/lake-cabin" \
-H "Authorization: Bearer $YCB_SYNDICATION_KEY"Checklist: when a stay appears under Find a Place
published: true and marketplace not forced offMore detail: Help · Free self-host website. Developer guide in the repo: docs/remote-open-source-marketplace.md.
Not in the open-source copy
Some hosted-platform tools (billing extras, internal research utilities) are intentionally excluded from this MIT inventory. Self-hosts set rates and operations on their own stack.
Version 0.1.0. When new capabilities ship on this platform, they're added to the open-source tree and listed here.
Each host gets their own public site under /h/[slug].
Optional multi-host discovery - hosts and listings opt in.
Everything guests need to picture the stay.
Base rates plus seasonal peaks without a booking commission.
Guest ↔ host communication in-app, with email to the customer address.
One calendar for direct, marketplace, and external channels.
Request → deposit → confirm (USD cash/card, or Bitcoin when enabled).
Monthly hosting fee per property - not a cut of bookings.
Platform operators and hosts manage their own scopes.
Airbnb-style profile hub for guests and hosts.
Modern app you can run locally or on a small VPS.
Browse the demo stays and calendars, then spin up your own copy with the same features.