# Contributing to Nylo

## Introdução Obrigado por considerar contribuir com o Nylo! Este guia ajudará você a entender como contribuir com o micro-framework. Seja corrigindo bugs, adicionando funcionalidades ou melhorando a documentação, suas contribuições são valiosas para a comunidade Nylo. Nylo é dividido em três repositórios: | Repositório | Finalidade | |------------|---------| | nylo | A aplicação boilerplate | | framework | Classes principais do framework (nylo_framework) | | support | Biblioteca de suporte com widgets, helpers e utilitários (nylo_support) |

## Primeiros Passos ### Faça Fork dos Repositórios Faça fork dos repositórios para os quais deseja contribuir: - Fork do Nylo Boilerplate - Fork do Framework - Fork do Support ### Clone seus Forks ``` bash git clone https://github.com/YOUR-USERNAME/nylo git clone https://github.com/YOUR-USERNAME/framework git clone https://github.com/YOUR-USERNAME/support ```

## Ambiente de Desenvolvimento ### Requisitos Certifique-se de ter os seguintes itens instalados: | Requisito | Versão Mínima | |-------------|-----------------| | Flutter | 3.24.0 ou superior | | Dart SDK | 3.10.7 ou superior | ### Vincular Pacotes Locais Abra o boilerplate do Nylo no seu editor e adicione sobrescritas de dependência para usar seus repositórios locais do framework e support: **pubspec.yaml** ``` yaml dependency_overrides: nylo_framework: path: ../framework # Caminho para seu repositório local do framework nylo_support: path: ../support # Caminho para seu repositório local do support ``` Execute `flutter pub get` para instalar as dependências. Agora, as alterações que você fizer nos repositórios do framework ou support serão refletidas no boilerplate do Nylo. ### Testando suas Alterações Execute o aplicativo boilerplate para testar suas alterações: ``` bash flutter run ``` Para alterações em widgets ou helpers, considere adicionar testes no repositório apropriado.

## Diretrizes de Desenvolvimento ### Estilo de Código - Siga o guia de estilo oficial do Dart - Use nomes significativos para variáveis e funções - Escreva comentários claros para lógicas complexas - Inclua documentação para APIs públicas - Mantenha o código modular e de fácil manutenção ### Documentação Ao adicionar novas funcionalidades: - Adicione comentários dartdoc a classes e métodos públicos - Atualize os arquivos de documentação relevantes, se necessário - Inclua exemplos de código na documentação ### Testes Antes de enviar alterações: - Teste em dispositivos/simuladores iOS e Android - Verifique a compatibilidade com versões anteriores quando possível - Documente claramente quaisquer alterações que quebrem compatibilidade - Execute os testes existentes para garantir que nada esteja quebrado

## Enviando Alterações ### Discuta Primeiro Para novas funcionalidades, é melhor discutir com a comunidade primeiro: - Discussões no GitHub ### Crie uma Branch ``` bash git checkout -b feature/your-feature-name ``` Use nomes descritivos para branches: - `feature/collection-view-pagination` - `fix/storage-null-handling` - `docs/update-networking-guide` ### Faça Commit das suas Alterações ``` bash git add . git commit -m "Add: Your feature description" ``` Use mensagens de commit claras: - `Add: CollectionView grid mode support` - `Fix: NyStorage returning null on first read` - `Update: Improve router documentation` ### Envie e Crie um Pull Request ``` bash git push origin feature/your-feature-name ``` Em seguida, crie um pull request no GitHub. ### Diretrizes para Pull Request - Forneça uma descrição clara das suas alterações - Referencie quaisquer issues relacionadas - Inclua capturas de tela ou exemplos de código, se aplicável - Certifique-se de que seu PR aborda apenas uma questão - Mantenha as alterações focadas e atômicas

## Reportando Problemas ### Antes de Reportar 1. Verifique se o problema já existe no GitHub 2. Certifique-se de que está usando a versão mais recente 3. Tente reproduzir o problema em um projeto novo ### Onde Reportar Reporte problemas no repositório apropriado: - **Problemas do Boilerplate**: nylo/issues - **Problemas do Framework**: framework/issues - **Problemas da biblioteca Support**: support/issues ### Modelo de Issue Forneça informações detalhadas: ``` markdown ### Description Brief description of the issue ### Steps to Reproduce 1. Step one 2. Step two 3. Step three ### Expected Behavior What should happen ### Actual Behavior What actually happens ### Environment - Flutter: 3.24.x - Dart SDK: 3.10.x - nylo_framework: ^7.0.0 - OS: macOS/Windows/Linux - Device: iPhone 15/Pixel 8 (if applicable) ### Code Example ```dart // Minimal code to reproduce the issue ``` ``` ### Obtendo Informações de Versão ``` bash # Flutter and Dart versions flutter --version # Check your pubspec.yaml for Nylo version # nylo_framework: ^7.0.0 ```