Repository navigation
Releases: ens-Emilio/zfrog
Release list
zfrog v0.1.3
Desktop release — AppImage/.deb (Linux) + .exe/.msi (Windows). Auto-update via GitHub Releases.
zfrog v0.1.1
Desktop release — AppImage/.deb (Linux) + .exe/.msi (Windows). Auto-update via GitHub Releases.
zfrog v0.1.0 — Design Reference Engine
zfrog v0.1.0 — Design Reference Engine
Capture, organize e adapte referências de design da web — offline, na sua máquina.
Sem versão hospedada, por design. Tudo roda local: screenshot + paleta + tokens.
Mascote em docs/mascot.png · Landing em landing/index.html · Dashboard em dashboard/
O que é
Ferramenta CLI + API + dashboard para transformar qualquer página em dado de design:
- jump — captura visual: screenshot full-page + tokens (cores, tipografia, espaçamento)
- tongue — inspeção de componente: HTML + CSS computado de um seletor
- Playwright (default) — renderiza JS/SPAs · Scrapy — mapeia o site · StaticFile/wget — páginas leves e assets
Pipeline completo: probe → captura → reescrita de links → limpeza de trackers → ZIP.
Destaques desta versão
- Dashboard TUI — 27 rotas (
/,/colecao,/probe,/captura,/busca,/fluxos,/chat,/comparar,/grafo,/precos,/datasets,/graphql,/qualidade,/analytics,/stats,/timeline,/snapshots,/workers,/revisao,/roi,/equipe,/config,/ajuda,/webhooks,/marketplace,/design) + design system TUI (dashboard/src/styles/tui.css, tokens#f4f2ec/#4f6b3a) + paletactrl+k - Desktop nativo (Tauri v2) —
.deb/.AppImage(Linux) e.nsis/.msi(Windows), sidecar Python empacotado via PyInstaller (src-tauri/binaries/zfrog-api-<triple>) - Browsers cache isolado —
~/.cache/zfrog/browsers(XDG_CACHE_HOME-aware) · fallbackGET /browsers/status+POST /browsers/installcom banner no dashboard - i18n pt/en/es — 1201 chaves (
dashboard/src/lib/i18n.ts), detecçãopt→en→es - 27 modos CLI —
jump,tongue,clone,pond,export,probe,delta,versions,schedule,search,chat,safety,analytics, e mais (zfrog --help)
Instalação rápida
git clone https://github.com/ens-Emilio/zfrog.git && cd zfrog
python -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/playwright install chromium
./zfrog dev # API http://127.0.0.1:8000 + dashboard http://localhost:3000Ou via instalador desktop (abaixo, em Assets quando o build terminar): baixe o .deb/.AppImage/.exe e instale — não precisa Python/Node.
Docker: docker compose up -d (Redis + worker + API).
Assets
zfrog_<versão>_amd64.deb— Debian/Ubuntuzfrog_<versão>_amd64.AppImage— Linux portávelzfrog_<versão>_x64-setup.exe/.msi— Windows
Build em andamento para esta tag (
Desktopworkflow). Assim que terminar, os instaladores aparecem aqui e em Actions → Artifacts.
Links
- Landing:
landing/index.html(estático, publica viawrangler.jsonc→pages_build_output_dir: "landing") - Docs:
docs/CONTEXTO.md,docs/PLANO-100.md,docs/PLANO-TAURI.md,README.md(EN) - Changelog técnico:
4bb46f3desktop browsers cache +0fef080/617ea48fixes de CI/Desktop (Vite, cp1252, tauri cwd, ruff F811/F821)
English — what is this?
Zfrog is a local-first design reference engine. Point it at any URL, it saves a browsable offline copy: screenshot, palette and design tokens. No cloud, no tracking. CLI + FastAPI + Vite/TanStack dashboard + Tauri desktop. See README.md for full usage.
Licença: Apache 2.0 — LICENSE · Requisitos: Python ≥3.11, Node 20 (dashboard), Rust (desktop).