Name: Cloudless
Address: GR

Prerequisites

Before you begin, make sure you have:

Node.js 20+ and pnpm installed
An AWS account with CLI configured (aws configure)
Git credential manager (GCM) for authenticated pushes
A Notion workspace (optional, for CMS features)

Clone & Install

git clone https://github.com/baltzakis-themis/cloudless.git
cd cloudless
pnpm install
cp .env.local.example .env.local

Environment Configuration

Edit .env.local with your values. Required for local dev:

Optional integrations (gracefully degraded if absent):

Production secrets live in AWS SSM at /cloudless/production/* — the Lambda reads them at cold start.

Running Locally

pnpm dev

Open http://localhost:3000. Hot reload is enabled via Next.js Turbopack.

Running Tests

pnpm test          # Vitest unit tests
pnpm test:e2e      # Playwright E2E (requires dev server running)

Deploying to AWS

# Staging (preview)
pnpm sst deploy --stage staging

# Production
pnpm sst deploy --stage production

SST v4 creates: CloudFront CDN → Lambda (OpenNext adapter) → S3 static assets. All infrastructure is defined in sst.config.ts.

Project Structure

src/
  app/[locale]/     Next.js App Router pages (i18n via next-intl)
  components/       Shared UI components
  lib/              Integration clients (Notion, Stripe, HubSpot, GSC, SES…)
  context/          React context (Auth, Cart, CookieConsent)
  locales/          i18n message files (en, el, fr)
public/
  sw.js             Service worker (offline support + push notifications)
  icons/            PWA icons
sst.config.ts       SST v4 infrastructure config

Cart (0)