telemetryflow/telemetryflow-landing repository overview

flowchart TB
    subgraph Internet["Internet"]
        User["User Browser"]
    end

    subgraph Server["Remote Host (AWS Lightsail)"]
        subgraph Nginx["Nginx Reverse Proxy"]
            R1[":80 / :443"]
        end

        subgraph Landing["tfo_landing_net"]
            LP["tfo-landing<br/>telemetryflow.id"]
        end

        subgraph Demo["tfo_viz_demo_net"]
            VD["tfo-viz-demo<br/>demo.telemetryflow.id"]
        end

        R1 --> LP
        R1 --> VD
    end

    User -->|HTTPS| R1

# Install dependencies
pnpm install

# Start development server (with mock data)
pnpm dev

# Build for production
pnpm build

# Preview production build
pnpm preview

# Type checking
pnpm type-check

# Run with Docker Compose (mock mode)
docker compose up -d

# Run local environment (landing + dashboard)
docker compose -f docker-compose.local.yml up -d

# Run full demo (with nginx + SSL)
docker compose -f docker-compose.demo.yml up -d

cd ansible

# Test connectivity
ansible-playbook playbooks/ping-all.yml

# Deploy full stack (Nginx + Certbot + Landing + Viz)
ansible-playbook playbooks/deploy-stack.yml

# Or via site.yml with tags
ansible-playbook playbooks/site.yml --tags stack

# Deploy individual components
ansible-playbook playbooks/deploy-website.yml
ansible-playbook playbooks/deploy-demo.yml

# 1. Configure Cloudflare API credentials
nano config/certbot/cloudflare.ini

# 2. Switch to HTTP-only mode for initial setup
./scripts/switch-nginx-mode.sh init
docker compose -f docker-compose.demo.yml restart nginx

# 3. Generate wildcard SSL certificate
docker compose -f docker-compose.demo.yml run --rm certbot certonly \
  --dns-cloudflare \
  --dns-cloudflare-credentials /etc/letsencrypt/cloudflare.ini \
  --email [email protected] \
  --agree-tos --no-eff-email \
  -d telemetryflow.id \
  -d '*.telemetryflow.id'

# 4. Switch to HTTPS mode and restart
./scripts/switch-nginx-mode.sh https
docker compose -f docker-compose.demo.yml restart nginx

docker compose -f docker-compose.demo.yml run --rm certbot certonly \
  --webroot --webroot-path=/var/www/certbot \
  --email [email protected] \
  --agree-tos --no-eff-email \
  -d telemetryflow.id -d www.telemetryflow.id

docker compose -f docker-compose.demo.yml run --rm certbot certonly \
  --webroot --webroot-path=/var/www/certbot \
  --email [email protected] \
  --agree-tos --no-eff-email \
  -d demo.telemetryflow.id

telemetryflow-website/
├── ansible/             # Ansible deployment automation
│   ├── playbooks/       # Site, deploy, install playbooks
│   ├── roles/           # docker-install, tfo-stack, tfo-landing, tfo-viz-demo, net-tools
│   ├── inventory.yml    # Host inventory
│   └── group_vars/      # Group & host variables
├── config/              # Infrastructure configuration
│   ├── nginx/           # Nginx reverse proxy configs
│   └── certbot/         # SSL certificate management
├── docs/                # Documentation (organized by topic)
│   ├── guides/          # How-to guides
│   ├── deployment/      # Deployment & infrastructure docs
│   ├── reference/       # Technical reference
│   └── release-notes/   # Release notes
├── frontend/            # Vue 3 frontend application
├── scripts/             # Build & utility scripts
├── website/             # Landing page static site
├── docker-compose.yml          # Main Docker Compose
├── docker-compose.demo.yml     # Demo (build from source)
├── docker-compose.demo-image.yml # Demo (pre-built images)
├── docker-compose.local.yml    # Local development
├── Dockerfile.frontend         # Frontend container
├── Dockerfile.website          # Landing page container
├── Makefile                    # Build automation
└── package.json                # Project manifest

make dev            # Start development server
make build          # Build for production
make docker-build   # Build Docker image
make up             # Start Docker services (mock mode)
make up-demo        # Start demo environment
make check          # Run type-check + lint
make help           # Show all available commands