{"id":31664082,"url":"https://github.com/natsalete/calculator","last_synced_at":"2026-05-18T02:07:28.481Z","repository":{"id":316062686,"uuid":"1056802221","full_name":"natsalete/Calculator","owner":"natsalete","description":"A modern and elegant calculator for Android built with Kotlin and XML, featuring an iOS-inspired design with a dark interface and circular buttons.","archived":false,"fork":false,"pushed_at":"2025-09-22T12:07:18.000Z","size":108,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-07T20:56:12.116Z","etag":null,"topics":["android","android-studio","calculadora","kotlin","material-design","mobile-app","xml-layout"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/natsalete.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-14T20:39:46.000Z","updated_at":"2025-09-22T12:07:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"5c42999a-e08b-4e55-b0f2-90415c79eeea","html_url":"https://github.com/natsalete/Calculator","commit_stats":null,"previous_names":["natsalete/calculator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/natsalete/Calculator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natsalete%2FCalculator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natsalete%2FCalculator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natsalete%2FCalculator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natsalete%2FCalculator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/natsalete","download_url":"https://codeload.github.com/natsalete/Calculator/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natsalete%2FCalculator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33162448,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-17T22:39:12.733Z","status":"online","status_checked_at":"2026-05-18T02:00:06.436Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-studio","calculadora","kotlin","material-design","mobile-app","xml-layout"],"created_at":"2025-10-07T20:54:11.940Z","updated_at":"2026-05-18T02:07:28.476Z","avatar_url":"https://github.com/natsalete.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🧮 Android Calculator\n\nA modern and elegant calculator for Android built with Kotlin and XML, featuring an iOS-inspired design with a dark interface and circular buttons.\n\n## 📱 Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\u003cimg src=\"https://github.com/user-attachments/assets/3658e1fb-5e24-498f-9719-ef30588e6576\" width=\"300\" /\u003e\n\u003c/div\u003e\n\n## ✨ Features\n\n### Basic Operations\n- ➕ **Addition**\n- ➖ **Subtraction**\n- ✖️ **Multiplication**\n- ➗ **Division**\n\n### Special Functions\n- 🔄 **C** - Clear screen completely\n- ⚡ **+/-** - Toggle positive/negative sign\n- 📊 **%** - Convert to percentage\n- ⌫ **Backspace** - Delete last digit entered\n\n### Advanced Features\n- 🔢 Decimal support\n- 🚫 Division by zero prevention\n- 📏 Automatic formatting of large numbers\n- 🎯 Input validation (avoids consecutive operators)\n- 📱 Responsive interface with visual feedback\n\n## 🎨 Design\n\n### Color Palette\n- **Background:** Black (#000000)\n- **Display:** Light gray (#E5E5E5)\n- **Numbers:** Dark gray (#333333)\n- **Operators:** Orange (#FF9500)\n- **Functions:** Medium gray (#A6A6A6)\n\n### Visual Features\n- Circular buttons with ripple effect\n- Display with rounded corners\n- Clear and legible typography\n- Responsive 4x5 grid layout\n\n## 🛠️ Technologies Used\n\n- **Language:** Kotlin\n- **Layout:** XML\n- **IDE:** Android Studio\n- **Minimum SDK:** API 21 (Android 5.0)\n- **Components:**\n- GridLayout for button organization\n- TextView for display\n- Custom drawable for styles\n\n## 🚀 How to Run\n\n### Prerequisites\n- Android Studio Arctic Fox or higher\n- Android SDK 21+\n- Android Device/Emulator\n\n### Installation Steps\n\n1. **Clone or download the project**\n```bash\ngit clone https://github.com/natsalete/Calculator\n```\n\n2. **Open in Android Studio**\n- File → Open → Select the project folder\n\n3. **Synchronize the project**\n- Click \"Sync Now\" when the notification appears\n\n4. **Run the application**\n- Click the \"Run\" button or Press `Shift + F10`\n- Select an Android device/emulator\n\n## 💡 How to Use\n\n1. **Numbers:** Tap the number buttons (0-9) to enter values.\n2. **Decimals:** Use the \".\" to enter decimal numbers\n3. **Operations:** Select +, -, ×, or ÷ to choose the operation\n4. **Result:** Press \"=\" to calculate the result\n5. **Clear:** Use \"C\" to clear completely or \"⌫\" to delete the last digit\n6. **Functions:**\n- \"+/-\" to toggle sign\n- \"%\" to convert to percentage\n\n## 🔧 Technical Features\n\n### Error Handling\n- Division by zero validation\n- Display character limit\n- Preventing multiple decimal points\n- Formatting of very large numbers\n\n### Validations\n- Blocked consecutive operator input\n- Checks for valid values ​​before calculations\n- Mathematical exception handling\n\n## 🎯 Upcoming Enhancements\n\n- [ ] Operation history\n- [ ] Advanced scientific operations\n- [ ] Customizable themes\n- [ ] Landscape mode support\n- [ ] ] Transition Animations\n- [ ] Vibration on Touches\n\n## 👨‍💻 Developer\n\nDeveloped with ❤️ for Android development learning.\n\n## 📄 License\n\nThis project is licensed under the MIT License. See the `LICENSE` file for more details.\n\n---\n\n⭐ **If this project was useful to you, don't forget to give it a star!** ⭐\n\n\u003cdetails\u003e\n\u003csummary\u003e🇧🇷 Versão em Português\u003c/summary\u003e\n\n# 🧮 Calculadora Android\n\nUma calculadora moderna e elegante para Android desenvolvida com **Kotlin** e **XML**, apresentando um design inspirado no iOS com interface escura e botões circulares.\n\n## 📱 Screenshots\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"https://github.com/user-attachments/assets/3658e1fb-5e24-498f-9719-ef30588e6576\" width=\"300\" /\u003e\n\u003c/div\u003e\n\n## ✨ Funcionalidades\n\n### Operações Básicas\n- ➕ **Adição**\n- ➖ **Subtração** \n- ✖️ **Multiplicação**\n- ➗ **Divisão**\n\n### Funções Especiais\n- 🔄 **C** - Limpar tela completamente\n- ⚡ **+/-** - Alternar sinal positivo/negativo\n- 📊 **%** - Converter para porcentagem\n- ⌫ **Backspace** - Apagar último dígito inserido\n\n### Recursos Avançados\n- 🔢 Suporte a números decimais\n- 🚫 Prevenção contra divisão por zero\n- 📏 Formatação automática de números grandes\n- 🎯 Validação de entrada (evita operadores consecutivos)\n- 📱 Interface responsiva com feedback visual\n\n## 🎨 Design\n\n### Paleta de Cores\n- **Fundo:** Preto (#000000)\n- **Display:** Cinza claro (#E5E5E5)\n- **Números:** Cinza escuro (#333333)\n- **Operadores:** Laranja (#FF9500)\n- **Funções:** Cinza médio (#A6A6A6)\n\n### Características Visuais\n- Botões circulares com efeito ripple\n- Display com cantos arredondados\n- Tipografia clara e legível\n- Layout responsivo em grid 4x5\n\n## 🛠️ Tecnologias Utilizadas\n\n- **Linguagem:** Kotlin\n- **Layout:** XML\n- **IDE:** Android Studio\n- **SDK Mínimo:** API 21 (Android 5.0)\n- **Componentes:** \n  - GridLayout para organização dos botões\n  - TextView para display\n  - Drawable personalizados para estilos\n\n\n## 🚀 Como Executar\n\n### Pré-requisitos\n- Android Studio Arctic Fox ou superior\n- SDK Android 21+\n- Dispositivo/Emulador Android\n\n### Passos para Instalação\n\n1. **Clone ou baixe o projeto**\n   ```bash\n   git clone https://github.com/natsalete/Calculator\n   ```\n\n2. **Abra no Android Studio**\n   - File → Open → Selecione a pasta do projeto\n\n3. **Sincronize o projeto**\n   - Clique em \"Sync Now\" quando aparecer a notificação\n\n4. **Execute a aplicação**\n   - Clique no botão \"Run\" ou pressione `Shift + F10`\n   - Selecione um dispositivo/emulador Android\n\n## 💡 Como Usar\n\n1. **Números:** Toque nos botões numéricos (0-9) para inserir valores\n2. **Decimais:** Use o botão \".\" para inserir números decimais\n3. **Operações:** Selecione +, -, ×, ou ÷ para escolher a operação\n4. **Resultado:** Pressione \"=\" para calcular o resultado\n5. **Limpar:** Use \"C\" para limpar completamente ou \"⌫\" para apagar o último dígito\n6. **Funções:** \n   - \"+/-\" para alternar sinal\n   - \"%\" para converter em porcentagem\n\n## 🔧 Recursos Técnicos\n\n### Tratamento de Erros\n- Validação de divisão por zero\n- Limite de caracteres no display\n- Prevenção de múltiplos pontos decimais\n- Formatação de números muito grandes\n\n### Validações\n- Entrada de operadores consecutivos bloqueada\n- Verificação de valores válidos antes dos cálculos\n- Tratamento de exceções matemáticas\n\n## 🎯 Próximas Melhorias\n\n- [ ] Histórico de operações\n- [ ] Operações científicas avançadas\n- [ ] Temas personalizáveis\n- [ ] Suporte a modo paisagem\n- [ ] Animações de transição\n- [ ] Vibração nos toques\n\n## 👨‍💻 Desenvolvedor\n\nDesenvolvido com ❤️ para aprendizado de desenvolvimento Android.\n\n## 📄 Licença\n\nEste projeto está sob a licença MIT. Veja o arquivo `LICENSE` para mais detalhes.\n\n---\n\n⭐ **Se este projeto foi útil para você, não esqueça de dar uma estrela!** ⭐\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatsalete%2Fcalculator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnatsalete%2Fcalculator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatsalete%2Fcalculator/lists"}