Skip to content

Releases: ens-Emilio/zfrog

zfrog v0.1.3

Choose a tag to compare

@github-actions github-actions released this 08 Oct 20:18

Desktop release — AppImage/.deb (Linux) + .exe/.msi (Windows). Auto-update via GitHub Releases.

zfrog v0.1.1

Choose a tag to compare

@github-actions github-actions released this 08 Oct 19:38

Desktop release — AppImage/.deb (Linux) + .exe/.msi (Windows). Auto-update via GitHub Releases.

zfrog v0.1.0 — Design Reference Engine

Choose a tag to compare

@ens-Emilio ens-Emilio released this 08 Oct 04:04

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) + paleta ctrl+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) · fallback GET /browsers/status + POST /browsers/install com banner no dashboard
  • i18n pt/en/es — 1201 chaves (dashboard/src/lib/i18n.ts), detecção pt→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:3000

Ou 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/Ubuntu
  • zfrog_<versão>_amd64.AppImage — Linux portável
  • zfrog_<versão>_x64-setup.exe / .msi — Windows

Build em andamento para esta tag (Desktop workflow). Assim que terminar, os instaladores aparecem aqui e em Actions → Artifacts.

Links

  • Landing: landing/index.html (estático, publica via wrangler.jsonc → pages_build_output_dir: "landing")
  • Docs: docs/CONTEXTO.md, docs/PLANO-100.md, docs/PLANO-TAURI.md, README.md (EN)
  • Changelog técnico: 4bb46f3 desktop browsers cache + 0fef080/617ea48 fixes 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).