tabAla/docker-compose.yml at main · vinimlo/tabAla · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
# =============================================================================
# TabAla - Docker Compose Configuration
# =============================================================================
# Development environment orchestration for the TabAla browser extension.
#
# Usage:
#   docker-compose up        # Start development server (foreground)
#   docker-compose up -d     # Start development server (background)
#   docker-compose down      # Stop and remove containers
#   docker-compose logs -f   # Follow container logs
#   docker-compose exec app sh  # Open shell in running container
#
# After starting, access the Vite dev server at: http://localhost:5173
# =============================================================================

services:
  # ---------------------------------------------------------------------------
  # Main Application Service
  # ---------------------------------------------------------------------------
  # Svelte + TypeScript + Vite development environment for the browser extension
  app:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: tabala-dev

    # Port mapping for Vite dev server
    ports:
      - "5173:5173"

    # Volume configuration for development workflow
    volumes:
      # Bind mount: sync source code for hot-reload
      - .:/app
      # Named volume: isolate node_modules to avoid OS-specific conflicts
      - node_modules:/app/node_modules

    # Environment variables for Vite development server
    environment:
      - NODE_ENV=development
      # Allow Vite to accept connections from outside the container
      - VITE_HOST=0.0.0.0
      # Enable polling for file changes (required for some OS/Docker combinations)
      - CHOKIDAR_USEPOLLING=true

    # Restart policy: auto-restart on failure but respect manual stops
    restart: unless-stopped

    # Enable interactive terminal for debugging
    stdin_open: true
    tty: true

    # Connect to project network
    networks:
      - tabala-network

# -----------------------------------------------------------------------------
# Named Volumes
# -----------------------------------------------------------------------------
# node_modules volume isolates dependencies from the host filesystem,
# preventing conflicts between different operating systems (e.g., Linux binaries
# in container vs macOS/Windows on host)
volumes:
  node_modules:

# -----------------------------------------------------------------------------
# Networks
# -----------------------------------------------------------------------------
# Bridge network for inter-service communication. Future services (database,
# cache, API) can join this network and communicate using service names as DNS.
networks:
  tabala-network:
    driver: bridge