Texugo Live Editor

Editor LaTeX local — alternativa ao Overleaf rodando inteiramente em Docker.

Stack

Camada	Tecnologia
Editor	CodeMirror 6 + codemirror-lang-latex
Frontend	Next.js 15, React 19, TypeScript
Backend	FastAPI (Python 3.12)
Compilador	Tectonic (TeX engine)
Container	Docker Compose

Pré-requisitos

• Docker (>= 20.10)
• Docker Compose (v2+)
• make (opcional, mas recomendado)

Nenhuma instalação local de Node.js, Python ou LaTeX é necessária — tudo roda dentro dos containers.

Build e execução

Desenvolvimento (hot reload)

# clonar o repositório
git clone https://github.com/Prism411/texugo-live-editor.git
cd texugo-live-editor

# build + subir containers em modo dev
make dev

# ou com uma pasta de workspace customizada
WORKSPACE=~/meus-artigos make dev

Isso executa docker compose -f docker-compose.dev.yml up --build, que:

1. Builda a imagem do frontend (Next.js) a partir de frontend/Dockerfile.dev
2. Builda a imagem do backend (FastAPI + Tectonic) a partir de backend/Dockerfile.dev
3. Monta o código-fonte local para hot reload automático

Produção

# build otimizado + subir containers em modo produção
make prod

Usa docker compose up --build com os Dockerfiles de produção (frontend/Dockerfile e backend/Dockerfile).

Build manual (sem Make)

# desenvolvimento
WORKSPACE_PATH=$(pwd)/_workspace docker compose -f docker-compose.dev.yml up --build

# produção
WORKSPACE_PATH=$(pwd)/_workspace docker compose up --build

Acesse http://localhost:3500

Variáveis de ambiente

Variável	Padrão	Descrição
WORKSPACE / WORKSPACE_PATH	./_workspace	Diretório local montado como workspace de arquivos .tex
NEXT_PUBLIC_API_URL	http://localhost:8500	URL da API (backend) para o frontend
CORS_ORIGINS	http://localhost:3500	Origens permitidas pelo CORS
COLLAB_ENABLED	false	Habilita colaboração em tempo real via Yjs (LAN)
COLLAB_HOST_IP	(vazio)	IP do host para modo colaborativo

Testes

# todos os testes (backend + frontend)
make test

# apenas backend (pytest)
make test-backend

# apenas frontend (vitest)
make test-frontend

Comandos Make

Comando	Descrição
make dev	build + sobe em modo desenvolvimento com hot reload
make prod	build + sobe em modo produção otimizado
make down	para todos os containers
make logs	acompanha logs em tempo real
make test	roda todos os testes
make clean	remove imagens e volumes

Atalhos do editor

Atalho	Ação
Ctrl+S	salvar arquivo
Ctrl+Enter	salvar e compilar
Ctrl+Z	desfazer
Ctrl+Shift+Z	refazer
Ctrl+F	buscar
Ctrl+H	buscar e substituir

Arquitetura

browser → Next.js (3500) → FastAPI (8500) → Tectonic → PDF
                                ↕
                        volume mount local

Nenhuma instalação local de LaTeX é necessária. Tudo roda dentro do Docker.