Documentation

Staybnb

A production-grade short-stay rental marketplace. Three apps — guest storefront, admin dashboard, and a REST API — in one Turborepo with shared Postgres, auth, payments, and design tokens. Thank you for your purchase.

Features

Requirements

• Node.js ≥ 18 (v22 LTS recommended) and pnpm 9
• PostgreSQL 14+ — Docker (port 5434) or managed
• Docker Desktop (optional, for local Postgres)
• Stripe account (test keys to start)
• Optional: Firebase, ImageKit/Cloudinary, SMTP

Quick start

Get a fully seeded marketplace running locally.

# 1. Install
pnpm install

# 2. Env files
cp apps/api/.env.example apps/api/.env
cp apps/admin/.env.example apps/admin/.env
cp apps/web/.env.example apps/web/.env.local

# 3. Local Postgres (host port 5434)
pnpm db:up
# DATABASE_URL=postgresql://staybnb:staybnb@localhost:5434/staybnb?schema=public

# 4. Migrate + seed
pnpm setup
pnpm seed

# 5. Run all apps
pnpm dev

Installation

1. 1Unzip & install. At the monorepo root run pnpm install. Always use pnpm.
2. 2Environment. Copy each app’s .env.example. API needs DATABASE_URL and JWT_SECRET at minimum.
3. 3Database. pnpm db:up starts Docker Postgres on 5434, or point DATABASE_URL at managed Postgres.
4. 4Migrate & seed. pnpm setup then pnpm seed.
5. 5Run. pnpm dev or pnpm dev:web / dev:admin / dev:api / dev:site.

Configuration

Key environment variables (see each app’s .env.example):

Third-party services

Stripe

1. Create keys at dashboard.stripe.com → set STRIPE_SECRET_KEY.
2. Webhook → API payments route → STRIPE_WEBHOOK_SECRET.
3. Match test/live mode between keys and webhook secret.

Firebase OAuth (optional)

1. Create a Firebase web app; copy public config into web/admin env.
2. Enable providers (Google, GitHub, etc.).
3. API needs the Admin service account for token verification.

Media & email

ImageKit (primary) or Cloudinary in apps/api. SMTP enables verification and booking mail.

Project structure

apps/
  web/      Guest storefront (Next.js 16, i18n, maps)
  admin/    Admin dashboard (Vite + React + shadcn)
  api/      REST API (Express 5 + Prisma 7)
  site/     Product marketing + /docs (this app)
packages/
  ui/
  eslint-config/
  typescript-config/

Docker: apps/api/docker-compose.yml → staybnb-postgres on host 5434.

Development

Roles

Admin guide

• •Sign in at admin.staybnb.reactbd.com (or localhost:5173).
• •Listings — approve, edit, feature, reject.
• •Bookings — stays, payments, cancellations.
• •Users — search, roles, flags.
• •Hosting applications — approve new hosts.
• •Content — banners, blogs, categories, amenities.

Customization

Brand

Primary is #FF385C. Tokens: apps/web/src/app/globals.css and apps/admin/src/index.css. Logos under each app’s public/.

Content

Managed in admin or via apps/api/scripts seed scripts.

i18n

Locales under apps/web/src/i18n.

Deployment

Production demos: staybnb.reactbd.com (client) and admin.staybnb.reactbd.com (admin).

Typical split: web on Vercel/Cloudflare, admin as static Vite build, API on Node host, Postgres on Neon. Marketing + docs: deploy apps/site (this app).

pnpm --filter api build
pnpm --filter web build
pnpm --filter admin build
pnpm --filter site build
pnpm --filter api db:deploy   # production DATABASE_URL

Go-live security checklist

• ☐Strong unique JWT_SECRET
• ☐Live Stripe keys + verified webhook
• ☐Change seeded passwords; remove demo users
• ☐Real CLIENT_URL / ADMIN_URL for CORS
• ☐Postgres SSL; not public
• ☐Replace demo media
• ☐HTTPS + rate limits on API
• ☐Disable dummy payment flags in production

Troubleshooting

Support & license

Purchase support follows your checkout terms. Include OS, Node version, exact command, and error output when asking for help.

Contact: www.reactbd.com/contact

One license = one end product. See LICENSE. Thank you for choosing Staybnb.