react-native-architecture

Visão Geral

O que é react-native-architecture?

react-native-architecture oferece um modelo prático para construir aplicações móveis React Native escaláveis e prontas para produção. Ele foca no uso do Expo, navegação avançada, integração de módulos nativos, padrões offline-first e uma estrutura de projeto robusta. Esta skill é ideal para desenvolvedores frontend e equipes móveis que desejam acelerar a entrega de apps seguindo as melhores práticas.

Para quem esta skill é indicada?

• Desenvolvedores iniciando novos projetos React Native ou Expo
• Equipes implementando fluxos complexos de navegação ou autenticação
• Projetos que precisam integrar módulos nativos ou APIs da plataforma
• Apps que exigem suporte offline e gerenciamento confiável de estado
• Quem busca otimizar performance React Native ou configurar CI/CD para mobile

Problemas que resolve

• Reduz o tempo de configuração com uma estrutura de projeto comprovada
• Esclarece quando usar Expo ou Bare React Native
• Guia a integração de módulos nativos e APIs da plataforma
• Suporta desenvolvimento offline-first e multiplataforma
• Ajuda a manter bases de código escaláveis e fáceis de manter

Como Usar

Passos para Instalação

1. Adicione a skill ao seu agente com:

   npx skills add https://github.com/wshobson/agents --skill react-native-architecture
   

2. Abra o arquivo SKILL.md para uma visão geral e orientações do fluxo de trabalho.
3. Consulte arquivos complementares como README.md, AGENTS.md e metadata.json para contexto aprofundado.
4. Explore os diretórios rules/, resources/, references/ e scripts/ para detalhes de implementação e utilitários auxiliares.

Visão Geral da Estrutura do Projeto

A estrutura recomendada inclui:

• src/app/: telas do Expo Router, organizadas por tipo de navegação (ex: auth, tabs)
• src/components/: componentes de UI e específicos de funcionalidades
• src/hooks/: hooks personalizados React
• src/services/: integrações com APIs e serviços nativos
• src/stores/: lógica de gerenciamento de estado
• src/utils/: funções utilitárias
• src/types/: definições de tipos TypeScript

Expo vs Bare React Native

• Expo: configuração mais simples, módulos nativos gerenciados, atualizações rápidas over-the-air
• Bare React Native: maior controle, linkagem manual de módulos nativos, maior complexidade
  Escolha Expo para a maioria dos projetos, a menos que precise de código nativo personalizado não suportado pelo Expo.

Adaptando a Skill

Em vez de copiar arquivos diretamente, adapte a arquitetura e os padrões para se encaixar no seu repositório, cadeia de ferramentas e convenções da equipe.

Perguntas Frequentes

Qual o principal benefício do react-native-architecture?

Oferece um ponto de partida claro e escalável para projetos React Native, reduzindo tempo de configuração e dívida técnica.

Posso usar isso em projetos React Native existentes?

Sim, você pode adotar gradualmente a estrutura e os padrões recomendados para melhorar a manutenção.

Esta skill é apenas para Expo?

Não. Embora o Expo seja recomendado para a maioria dos casos, a arquitetura também suporta Bare React Native quando são necessárias integrações nativas personalizadas.

Por onde começo após a instalação?

Comece pelo arquivo SKILL.md para uma visão geral, depois explore a árvore de arquivos para orientações detalhadas e exemplos.

Como vejo todos os arquivos e scripts disponíveis?

Use a aba Files para navegar pela árvore completa de arquivos, incluindo referências aninhadas e scripts auxiliares.