Skip to content

marcelopepis/FrameGuard

Repository files navigation

FrameGuard

FrameGuard

Utilitário de manutenção e otimização para Windows 11, feito por gamers, para gamers.
Interface moderna, backend nativo em Rust e zero telemetria.

Windows 11 Tauri v2 React 19 Rust GPL v3

Download · Screenshots · Features · Instalação · Roadmap


O que é o FrameGuard?

O FrameGuard é uma ferramenta 100% gratuita e open-source que reúne otimizações, manutenção e limpeza do Windows 11 em um único lugar.

Sem versão PRO, sem funcionalidade trancada atrás de paywall, sem telemetria, sem ads. Todo o código é aberto, auditável, e sempre será.

Cada tweak tem classificação de evidência (comprovado, plausível ou não comprovado), detalhes técnicos completos e reversão com um clique. Você decide o que aplica, sabendo exatamente o que vai acontecer no seu sistema.

Screenshots

Dashboard
Dashboard — Visão geral do hardware, status do sistema e planos rápidos

Otimizações
Otimizações — 21 tweaks organizados por categoria com níveis de risco e evidência

Privacidade
Privacidade — Controle de telemetria, remoção de bloatware UWP e apps em segundo plano

Manutenção
Manutenção — DISM, SFC, chkdsk, TRIM e flush DNS com progresso em tempo real

Features

Otimizações

  • 21 tweaks de GPU, CPU, rede, armazenamento e timers com classificação de evidência
  • Filtro automático por hardware — detecta GPU (NVIDIA/AMD/Intel) e CPU, exibe apenas tweaks compatíveis
  • Backup automático do valor original antes de cada alteração; reversão com um clique

Privacidade

  • 4 tweaks de privacidade e telemetria (registro + política de grupo)
  • Remoção de bloatware UWP em batch com lista curada de 41 apps
  • Controle de apps em segundo plano

Manutenção

  • DISM (CheckHealth, ScanHealth, RestoreHealth), SFC, chkdsk, SSD TRIM, flush DNS
  • Streaming de progresso em tempo real para cada operação

Limpeza

  • Scan categorizado: temporários do sistema, GPU shader cache, browser cache, cache de apps, avançado (WinSxS)
  • Seleção granular por item com detecção de file locks (Restart Manager API)

Serviços

  • 33 serviços e 8 tarefas agendadas curados para gaming
  • Desabilitar/restaurar com um clique

Planos de Execução

  • Combine múltiplos tweaks em rotinas reutilizáveis
  • 4 planos oficiais incluídos: Manutenção Básica, Saúde Completa, Otimização Gaming, Privacidade e Debloat
  • Criação de planos personalizados

Mais

  • Busca global (Ctrl+K) para encontrar qualquer tweak, ação ou plano
  • Ponto de restauração automático antes de planos (configurável)
  • Export/import de configurações em arquivo .fg (JSON legível)
  • Página educacional desmistificando otimizações "snake oil"
  • Verificação de atualizações via GitHub Releases

Requisitos

  • Windows 11 (x64)
  • Privilégios de administrador (elevação via UAC automática)

Instalação

Download direto

Baixe o instalador .exe mais recente na página de Releases.

Build local

# Pré-requisitos: Node.js 20+, Rust toolchain, Visual Studio Build Tools
git clone https://github.com/marcelopepis/FrameGuard.git
cd FrameGuard
npm install
npm run tauri build

O instalador NSIS será gerado em src-tauri/target/release/bundle/nsis/.

Roadmap

O FrameGuard está em desenvolvimento ativo. Próximos passos planejados:

v1.1

  • Tema claro sincronizado com a preferência do Windows
  • Revisão de tweaks: adicionar novos com evidência e remover os que se provarem ineficazes
  • Animações e transições refinadas

v1.2

  • Refactoring de módulos grandes (optimizations.rs, cleanup.rs, Plans.tsx)
  • Mais mitos e explicações na página educacional
  • Recomendações por perfil de hardware

v2.0

  • Publicação na Microsoft Store
  • Auto-updater nativo
  • Perfis de otimização compartilháveis pela comunidade

Sugestões são bem-vindas — abra uma Issue.

Desenvolvimento

npm run dev          # Vite dev server + Tauri dev (hot reload)
npm run build        # Build de produção (tsc + vite + cargo)
npm run tauri build  # Gera instalador NSIS

Stack

Camada Tecnologia Versão
Frontend React + TypeScript (Vite) React 19, Vite 7, TS 5.8
Backend Tauri v2 + Rust Tauri 2, Edition 2021
Ícones lucide-react 0.564+
Roteamento react-router-dom 7.13+
Registro winreg 0.55
Sistema sysinfo 0.33

Estrutura do projeto

FrameGuard/
├── src/                    # Frontend React/TypeScript
│   ├── components/         # ActionCard, Layout, SearchBar, Toast, WelcomeModal
│   ├── contexts/           # RunningContext, ToastContext
│   ├── hooks/              # useActionRunner, useHardwareFilter, usePlanExecution
│   ├── pages/              # 10 páginas (Dashboard, Optimizations, Privacy, ...)
│   └── midia/              # Screenshots e assets visuais
├── src-tauri/              # Backend Rust
│   ├── src/commands/       # Comandos Tauri (system_info, optimizations, cleanup, ...)
│   └── src/utils/          # Backup, plan_manager, activity_log, command_runner, ...
└── CLAUDE.md               # Guia de arquitetura e desenvolvimento

Segurança

  • Elevação de administrador via manifest.xml (UAC nativo do Windows)
  • Backup automático de valores originais antes de qualquer modificação
  • Detecção de file locks via Restart Manager API
  • Zero telemetria — nenhuma conexão externa exceto verificação de updates no GitHub
  • Configurações salvas em JSON legível em %APPDATA%\FrameGuard

Contribuindo

Pull requests são bem-vindos. Consulte o CLAUDE.md para detalhes sobre arquitetura e convenções.

Para sugerir um novo tweak, use o template de sugestão. O FrameGuard só inclui tweaks com evidência real de impacto.

Licença

Este projeto está licenciado sob a GNU General Public License v3.0.


O FrameGuard é e sempre será 100% gratuito — sem versão PRO, sem paywall, sem pegadinha.
Se o projeto te ajudou e você quiser contribuir com qualquer valor, o PIX está aberto.
Totalmente opcional — o app funciona igual pra todo mundo.

PIX

Feito por Marcelo Pepis

GitHub LinkedIn Instagram

About

App para rodar manutenções do Windows e Tweaks

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors