mirror of https://github.com/Frooodle/Stirling-PDF.git synced 2025-12-18 20:04:17 +01:00

History

Anthony Stirling b0397da19e PDF Text editor (#4724 ) ## Summary - add a `PdfJsonConversionService` that serializes PDF text, fonts, and metadata to JSON and rebuilds a PDF from the same structure - expose REST endpoints for `/pdf/json` and `/json/pdf` conversions using the existing convert API infrastructure - define JSON model classes capturing document metadata, font information, and positioned text elements ## Testing - `./gradlew spotlessApply` (fails: plugin org.springframework.boot:3.5.4 unavailable in build environment) - `./gradlew build` (fails: plugin org.springframework.boot:3.5.4 unavailable in build environment) ------ https://chatgpt.com/codex/tasks/task_b_68f8e98d94ac8328a0e499e541528b6f --------- Co-authored-by: EthanHealy01 <ethan.healy.21@gmail.com>		2025-11-24 14:15:02 +00:00
..
backend	PDF Text editor (#4724 )	2025-11-24 14:15:02 +00:00
compose	PDF Text editor (#4724 )	2025-11-24 14:15:02 +00:00
frontend	PDF Text editor (#4724 )	2025-11-24 14:15:02 +00:00
unified	Settings display demo and login fix (#4884 )	2025-11-14 13:02:45 +00:00
Dockerfile.unified	Add audit system, invite links, and usage analytics (#4749 )	2025-11-06 17:29:34 +00:00
README.md	Feature/v2/googleDrive (#4592 )	2025-10-09 10:22:17 +01:00

README.md

Docker Setup for Stirling-PDF

This directory contains the organized Docker configurations for the split frontend/backend architecture.

Directory Structure

docker/
├── backend/           # Backend Docker files
│   ├── Dockerfile            # Standard backend
│   ├── Dockerfile.ultra-lite # Minimal backend
│   └── Dockerfile.fat        # Full-featured backend
├── frontend/          # Frontend Docker files
│   ├── Dockerfile     # React/Vite frontend with nginx
│   ├── nginx.conf     # Nginx configuration
│   └── entrypoint.sh  # Dynamic backend URL setup
└── compose/           # Docker Compose files
    ├── docker-compose.yml           # Standard setup
    ├── docker-compose.ultra-lite.yml # Ultra-lite setup
    └── docker-compose.fat.yml       # Full-featured setup

Usage

Separate Containers (Recommended)

From the project root directory:

# Standard version
docker-compose -f docker/compose/docker-compose.yml up --build

# Ultra-lite version
docker-compose -f docker/compose/docker-compose.ultra-lite.yml up --build

# Fat version
docker-compose -f docker/compose/docker-compose.fat.yml up --build

Access Points

Frontend: http://localhost:3000
Backend API (debugging): http://localhost:8080 (TODO: Remove in production)
Backend API (via frontend): http://localhost:3000/api/*

Configuration

Backend URL: Set VITE_API_BASE_URL environment variable for custom backend locations
Custom Ports: Modify port mappings in docker-compose files
Memory Limits: Adjust memory limits per variant (2G ultra-lite, 4G standard, 6G fat)

Google Drive Integration

VITE_GOOGLE_DRIVE_CLIENT_ID: OAuth 2.0 Client ID
VITE_GOOGLE_DRIVE_API_KEY: Create New API
VITE_GOOGLE_DRIVE_APP_ID: This is your project number in the GoogleCloud Settings

Development vs Production

Development: Keep backend port 8080 exposed for debugging
Production: Remove backend port exposure, use only frontend proxy