Skip to main content

ØSTEN AI Documentation

A modern marketing platform with a Next.js frontend and an Express/TypeScript backend. This docs section provides an overview, setup, architecture, OAuth integrations, API endpoints, deployment, analytics, and troubleshooting.

Table of Contents​

  • Architecture: docs/architecture.md
  • Local Setup: docs/setup-local.md
  • Frontend Guide: docs/frontend.md
  • Backend Guide: docs/backend.md
  • OAuth & Integrations: docs/oauth.md
  • API Endpoints: docs/apis.md
  • Deployment: docs/deployment.md
  • Analytics (GA4): docs/analytics.md
  • Troubleshooting: docs/troubleshooting.md

Quick Start​

  1. Follow docs/setup-local.md to configure environments
  2. Run backend, then frontend
  3. Connect ad platforms via dashboard; see docs/oauth.md

Key Paths​

  • Frontend app: frontend/
  • Backend service: backend/
  • Google Ads routes: backend/src/routes/googleAdsRoutes.ts
  • Google Ads controller: backend/src/controllers/googleAdsController.ts
  • Google Ads service: backend/src/services/googleAdsService.ts
  • Frontend API client: frontend/lib/api-client.ts
  • Google Ads OAuth success page: frontend/app/oauth/google-ads/success/page.tsx