Canopy Architecture | OneEnergy Together

Ecosystem Overview

Three interconnected layers form the OneEnergy Together business. The company website drives leads, the studio builds credibility, and Canopy is the scalable platform that powers every client site.

OneEnergy Together

onenergytogether.com

The parent company and wellness platform. Free value through assessments, habits, routines, and content. Drives inbound leads.

Next.js 15 + Firebase

Cloudflare Pages

Resend email

Studio

studio.onenergytogether.com

The credibility and consulting layer. Case studies, services showcase, 1-on-1 consulting bookings. Shows what we build.

Subdomain of main site

Middleware rewrite

Case studies + portfolio

Canopy Platform

Multi-tenant SaaS

The scalable platform powering every client site. One codebase, many businesses. Config-driven, zero code per new client.

Astro 5 + React 19

PayloadCMS 3.x

7 client sites live

How They Connect

Architecture

Monorepo Structure (Turborepo + pnpm)

apps/

cms (PayloadCMS)

oet-website (Next.js)

packages/

ui (25 components)

config (YAML loader)

ai (utilities)

templates/

starter-restaurant

canopy-landing

sites/

taste-buds

demo-restaurant

chennai-flavors

ninos-barber

+ 3 more

scripts/

new-client.ts

deploy-client.ts

create-demo.ts

+ 9 more

CMS Backend

PayloadCMS 3.x on Next.js 15 → Railway

18 Collections

Users

Tenants

Pages

Services

MenuItems

DailyMenus

SpecialMenus

Orders

Subscribers

SubscriptionPlans

Announcements

Messages

Testimonials

TeamMembers

Media

Leads

AgentRuns

KnowledgeEntries

Stack

FrameworkNext.js 15 + Payload 3

DatabaseNeon PostgreSQL

StorageCloudflare R2 (S3)

EditorLexical

DeployRailway (Docker)

Health/admin endpoint

Plugins

@payloadcms/plugin-multi-tenant

@payloadcms/plugin-seo

@payloadcms/storage-s3

1 Global

KitchenStatus (real-time availability toggle)

OET Website

Next.js 15 + Firebase → Cloudflare Pages

Pages

/ — Landing (wellness platform)

/products — Product catalog

/about — Company mission

/contact — Form (Resend + Web3Forms)

/case-studies — Client success stories

/studio — Design system showcase

/blog — Migrated from WordPress

/rss.xml — RSS feed

Stack

FrameworkNext.js 15.4

UIReact 19 + shadcn/ui

AuthFirebase Auth

DatabaseFirestore

EmailResend + Web3Forms

EditorTipTap

DeployCloudflare Pages

Shared Packages

ui, config, ai — used by all sites

@canopy/ui

10 React Islands

OrderInquiryForm, SubscribeWidget

WeeklyMenu, TodayMenu

MenuShareButton, PlanCards

BookingWidget, ContactForm

GalleryLightbox, PushSubscribe

15 Astro Components

Hero, Navbar, Footer, Gallery

ServiceCard, ServiceGrid

TestimonialCard, TestimonialSlider

Hours, LocationMap, WhatsAppButton

ClickToCall, SEOHead, PWAPrompt, TeamMember

@canopy/config

loadConfig.ts — reads site.config.yaml

types.ts — SiteConfig, ThemeConfig

index.ts — exports

Fallback chain: SITE_CONFIG_PATH env → pwd → template default

@canopy/ai

client.ts — AI API client

knowledge.ts — knowledge base

types.ts — Prospect, Dossier, etc.

prompts/ — prompt templates

Used by scripts for demo creation, market research, pitch coaching

Client Sites

7 deployed sites

Slug	Business	Type	Template	Status
taste-buds	Andhra Brahmin Home Kitchen	Restaurant	Custom Astro	Active
demo-restaurant	Generic Demo	Restaurant	starter-restaurant	Demo
chennai-flavors	Indian Restaurant	Restaurant	Custom Astro	Active
noforksgiven	Restaurant	Restaurant	Custom Astro	Active
freestyle-barbershop	Barbershop	Salon	Custom Astro	Active
ninos-barber	Barber Shop	Salon	Custom Astro	Active
handyman-nick	Contractor	Contractor	Custom Astro	Active

Services & Costs

Free Tiers Only

$0

per month

Active Usage

~$50-75

per month

At Scale (20+ clients)

~$150-250

per month

Cloudflare Pages

Free

Static site hosting for all client sites + OET website

Unlimited bandwidth, free SSL, unlimited projects

pages.cloudflare.com →

Cloudflare R2

Free 10GB

S3-compatible media storage, zero egress fees

Bucket: canopy-media. 10GB free, 10M Class A ops/mo

cloudflare.com/r2 →

Railway

~$5-20/mo

CMS backend hosting (Docker container)

Usage-based. $5 hobby / $20 pro. Hosts PayloadCMS.

railway.app →

Neon PostgreSQL

Free 0.5GB

Serverless Postgres for CMS database

Scale-to-zero, auto-suspend. $19/mo after free tier.

neon.tech →

Firebase

Free (Spark)

OET website: Auth, Firestore, Storage

Spark plan free. Blaze (pay-as-you-go) ~$25/mo at scale.

firebase.google.com →

Resend

Free 100/day

Transactional email + subscriber notifications

100 emails/day free. $20/mo for 50k emails.

resend.com →

Web3Forms

Free

Contact form fallback for OET website

250 submissions/month free tier.

web3forms.com →

Twilio

Pay-per-use

SMS + WhatsApp for restaurant client sites

~$0.0079/SMS, ~$0.005/WhatsApp msg. Phone # ~$1/mo.

twilio.com →

Anthropic Claude API

Per-token

AI content generation, demos, market research

Haiku: $0.25/$1.25/MTok. Sonnet: $3/$15/MTok. Varies by usage.

anthropic.com →

fal.ai (FLUX)

~$0.03/img

AI image generation for hero images

Used when clients don't have photos. Pay per generation.

fal.ai →

Stripe

2.9% + $0.30

Client billing & subscription payments (planned)

Per transaction fee. No monthly cost. Not yet wired.

stripe.com →

Cal.com

Free

Embeddable booking widget for service businesses

Open-source, self-hosted. Free plan available.

cal.com →

GitHub Actions

Free 2000 min

CI/CD for all deployments (3 pipelines)

2000 min/mo free for private repos.

github.com/actions →

Data Flow

Content Pipeline: Admin → Live Site

AI Content Generation Pipeline

Deployment Pipelines

Client Site Deploy

deploy-site.yml

Manual Trigger
slug input

Checkout

pnpm install

turbo build
--filter={slug}

Cloudflare Pages
canopy-{slug}

OET Website

deploy-oet.yml

Push to main
apps/oet-website/**

Checkout

next-on-pages
+ Firebase env

Cloudflare Pages
oet-website

Canopy Landing

deploy-landing.yml

Push to main
templates/canopy-landing/**

Checkout

turbo build
--filter=canopy-landing

Cloudflare Pages
canopy-platform

CMS Backend

railway.json

Railway
auto-deploy

Dockerfile

next build
+ payload config

next start
/admin healthcheck

Multi-Tenant Architecture

Tenant Isolation

Every collection scopes data via req.user.tenant. Super-admins see all.

Plugin

@payloadcms/plugin-multi-tenant

Access Control

Each request filtered by user's tenant ID

Database

Single Neon DB, tenant column per row

Config-Driven Sites

The formula: Template + site.config.yaml = Unique site

tenant: joes-pizza
template: starter-restaurant
business:
  name: "Joe's Pizza"
  type: restaurant
theme:
  primary: "#D4380D"
  fontHeading: "Playfair Display"
features:
  whatsapp: true
  booking: false
            

Theme Injection

CSS custom properties from config. Never hardcode colors.

<!-- BaseLayout.astro -->
<style define:vars={{
  'canopy-primary': theme.primary,
  'canopy-secondary': theme.secondary,
  'canopy-font-heading': theme.fontHeading,
}}>

/* Components use: */
color: var(--canopy-primary);
font-family: var(--canopy-font-heading);
            

Growth & Scaling

7

Client Sites

18

CMS Collections

25

Shared Components

4

CI/CD Pipelines

Adding a New Client (Zero Code)

1

Scaffold

pnpm new-client joes-pizza restaurant

Creates sites/joes-pizza/ with site.config.yaml + package.json

2

Configure

Edit site.config.yaml with business details, theme, features

3

Create Tenant

Add tenant in CMS admin panel (or via API)

4

Deploy

pnpm deploy joes-pizza

Live at joes-pizza.canopy.oneenergytogether.com

Pricing Tiers (Stripe)

Starter

Website + WhatsApp + SEO

Custom domain

WhatsApp button

SEO optimization

Google Business

Professional

+ Booking + Ordering + Subs

Everything in Starter

Online booking

Order system

Subscription plans

Premium

+ AI + Analytics + CRM

Everything in Pro

AI content updates

Analytics dashboard

CRM integration

Enterprise

White-glove custom

Everything in Premium

Custom integrations

Priority support

Custom design

Target Markets (4 verticals x 5 clients = 20 POC)

🍴

Restaurants / Food

Menu, daily specials, orders, subscriptions

starter-restaurant (built)

✂️

Barbers / Salons

Booking, portfolio, reviews, before/after

starter-salon (next)

🔧

Home Service Contractors

Quote form, project gallery, service areas

starter-contractor (next)

🏋️

Fitness / Wellness

Class schedule, membership, instructor bios

starter-fitness (next)

Environment Variables

Root .env (CMS + Scripts)

# Database (Neon PostgreSQL)
DATABASE_URL=postgresql://...
PAYLOAD_SECRET=<openssl rand -base64 32>

# Cloudflare
CLOUDFLARE_ACCOUNT_ID=788b314c...
CLOUDFLARE_API_TOKEN=...

# R2 Storage
S3_BUCKET=canopy-media
S3_ENDPOINT=https://...r2.cloudflarestorage.com
S3_ACCESS_KEY_ID=...
S3_SECRET_ACCESS_KEY=...

# AI
ANTHROPIC_API_KEY=...

# Email + SMS
RESEND_API_KEY=...
TWILIO_ACCOUNT_SID=...
TWILIO_AUTH_TOKEN=...
TWILIO_PHONE_NUMBER=...

# Billing
STRIPE_SECRET_KEY=...
FAL_KEY=...
            

OET Website .env.local

# Firebase (public)
NEXT_PUBLIC_FIREBASE_API_KEY=...
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=...
NEXT_PUBLIC_FIREBASE_PROJECT_ID=onenergytogether
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=...
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=...
NEXT_PUBLIC_FIREBASE_APP_ID=...

# Email + Forms
RESEND_API_KEY=...
CONTACT_EMAIL=1energytogether@gmail.com
WEB3FORMS_ACCESS_KEY=...
            

Per-Site .env.local

PUBLIC_CMS_API_URL=https://cms.canopy.onenergytogether.com
PUBLIC_SITE_URL=https://{slug}.canopy.onenergytogether.com
            