App do MacMagazine para iOS

O aplicativo do MacMagazine agora é um projeto de código aberto (open source), para que a enorme comunidade de desenvolvedores/leitores do site possa colaborar e construir um app cada vez melhor e mais completo.

Funcionalidades

• Posts com imagens dos artigos
• Compartilhamento de posts
• Favoritar posts
• Podcasts, com compartilhamento e favoritar
• Videos, com compartilhamento e favoritar
• Buscas em Posts, Podcasts e Videos
• Notificações push de todos os posts ou apenas de destaques
• WKWebView para leitura dos artigos e visualização dos comentários
• Modo Escuro
• Fontes dinâmicas para melhor visualização
• Leitura dos posts em fullscreen no iPad
• App para watchOS
• Widgets, tanto na Lock Screen como na Home screen

Sobre esta versão

• Totalmente escrita em Swift e usando SwiftUI
• Interface Liquid Glass
• Design diferenciado por plataforma: iOS, iPadOS, macOS e watchOS
• Totalmente modular usando Swift Package Manager
• Analytics usando Firebase
• Uso de Swift Concurrency, SwiftData, SwiftTest
• Sincronização entre dispositivos usando iCloud

Requisitos

• Xcode e Swift atualizados na última versão
• iOS 26+

Começando

Para instruções completas sobre como configurar o ambiente, contribuir com código, criar pull requests e muito mais, consulte nosso Guia de Contribuição.

Configuração rápida

# Clone o repositório
git clone https://github.com/MacMagazine/app-iOS.git
cd app-iOS
# Configure o Firebase (cria arquivo de configuração local)
./Support/Scripts/setup-firebase.sh
# Abra o projeto no Xcode
open MacMagazine/MacMagazine.xcodeproj

Contribuindo

Quer contribuir? Consulte o Guia de Contribuição para instruções detalhadas sobre:

• Configuração do ambiente de desenvolvimento
• Padrões de código e SwiftLint
• Fluxo de trabalho com branches
• Como criar Pull Requests
• Validações automáticas (GitHub Actions)

Desenvolvimento com IA (Claude Code)

O projeto é configurado para desenvolvimento assistido por IA usando o Claude Code, com guardrails que garantem que o código gerado siga os padrões do projeto.

Como funciona

O arquivo CLAUDE.md é a "constituição" do projeto — carregado em toda sessão, define as regras de ouro, comandos de build e o contrato anti-alucinação. O detalhamento fica em .claude/:

CLAUDE.md ← regras principais (carregado em toda sessão)
.claude/
rules/ ← convenções detalhadas, lidas sob demanda
(arquitetura, cards/WebView/tema, SwiftData/busca,
estilo Swift, concorrência, testes, git)
skills/ ← workflows reutilizáveis (/ios-start, /ios-implement,
/ios-fix, /ios-dod, /ios-design-guidelines,
/ios-sanity-check)
agents/ ← subagentes especializados (ios-principal-engineer,
swift-code-reviewer, architecture-guardian, test-runner)
hooks/ ← guardrails determinísticos (bloqueiam comandos
perigosos e rodam SwiftLint a cada arquivo editado)
settings.json ← permissões compartilhadas + ativação dos hooks

Como usar

# Na raiz do repositório — o CLAUDE.md carrega automaticamente
claude
# Fluxo típico de uma feature> /ios-start # checklist antes de escrever código> /ios-implement # implementação seguindo os padrões do projeto> /ios-dod # Definition of Done: build + testes + lint reais# Correção de bug> /ios-fix # análise de causa raiz antes de qualquer correção# Revisão e auditoria> use o agente swift-code-reviewer # revisão rigorosa do diff> use o agente architecture-guardian # verifica fronteiras entre módulos> /ios-sanity-check # auditoria de saúde do código

Guardrails

• Permissões (.claude/settings.json): toolchain pré-aprovado (xcodebuild, swiftlint, git, gh); leitura de segredos (GoogleService-Info.plist, *.xcconfig, certificados) e comandos destrutivos negados.
• Hooks: rm -rf, sudo, force-push e git reset --hard são bloqueados; todo arquivo Swift editado passa por swiftlint --strict na hora; try!, as! e @unchecked Sendable são rejeitados automaticamente.
• Qualidade: nada é considerado "pronto" sem build, testes e lint passando com saída real — nunca resultados presumidos.

Preferências pessoais (modelo, permissões extras da sua máquina) vão em .claude/settings.local.json, que não é versionado.

Bug Reporting e Feature Requests

Use as Issues para:

• Reportar problemas encontrados
• Sugerir novas funcionalidades

Documentação adicional

Documento	Descrição
CONTRIBUTING.md	Guia completo de contribuição
FIREBASE.md	Configuração do Firebase
CLAUDE.md	Regras para desenvolvimento assistido por IA (Claude Code)
.claude/skills/README.md	Referência rápida de skills e agentes

---

Bom desenvolvimento!

Equipe MM :-)