docs: add comprehensive changelog and update README

- Add CHANGELOG.md following Keep a Changelog format
- Document all changes from v0.1.0 to v0.2.0
- Update README.md with better documentation
- Add usage examples and feature highlights
- Include emojis for better visual organization
- Reference changelog from README

Author: andrekutianski

CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.2.0] - 2025-10-28
+
+### Added
+- **New Operation**: "Get State by Code" - Get detailed information about a specific state/province
+  - Uses `State.getStateByCodeAndCountry(stateCode, countryCode)` method
+  - Returns state name, ISO code, country code, latitude, and longitude
+  - Examples: California (US,CA), São Paulo (BR,SP), Ontario (CA,ON)
+
+### Changed
+- **Enhanced UI/UX**: Improved operation descriptions and field labels
+- **Better placeholders**: Added helpful examples for Country Code (`"e.g., US, BR, CA"`) and State Code (`"e.g., CA, NY, SP"`)
+- **Detailed descriptions**: Each operation now includes clear, descriptive help text
+
+### Technical
+- Updated TypeScript compilation targets
+- Improved error handling and validation
+- Enhanced code documentation
+
+## [0.1.0] - 2025-10-28
+
+### Added
+- **Initial release** of n8n Country State City node
+- **Core Operations**:
+  - `Get Country by Code` - Retrieve country details by ISO code
+  - `Get States by Country` - List all states/provinces in a country  
+  - `Get Cities by State` - List all cities in a state/province
+- **Features**:
+  - Built for n8n workflow automation platform
+  - Uses offline `country-state-city` library v3.1.2
+  - No API keys required - works completely offline
+  - Fast, reliable geographical data access
+  - Support for all ISO country codes and state codes
+
+### Technical
+- TypeScript implementation with proper type definitions
+- CommonJS module support for n8n compatibility
+- Proper n8n node structure following community standards
+- Comprehensive error handling and input validation
+- Complete build pipeline with TypeScript compilation
+
+### Fixed
+- **Node loading issues**: Fixed "Class could not be found" error
+- **Export structure**: Changed from `export default` to named exports
+- **Package configuration**: Updated package.json to follow n8n-nodes-starter pattern
+- **Dependencies**: Configured proper peer dependencies for n8n-workflow
+- **Imports**: Fixed country-state-city library imports for CommonJS compatibility
+
+## [Links]
+- [0.2.0]: https://github.com/mimirtechco/n8n-nodes-country-state-city/releases/tag/v0.2.0
+- [0.1.0]: https://github.com/mimirtechco/n8n-nodes-country-state-city/releases/tag/v0.1.0
+- [Unreleased]: https://github.com/mimirtechco/n8n-nodes-country-state-city/compare/v0.2.0...HEAD

README.md

@@ -6,11 +6,63 @@ Este é um pacote de node n8n que fornece funcionalidade para consultar informa
 
 Siga as instruções na [documentação do n8n](https://docs.n8n.io/integrations/community-nodes/installation/) para instalar nodes da comunidade.
 
+```bash
+npm install n8n-nodes-country-state-city
+```
+
 ## Operações
 
-*   **Get Country by Code**: Retorna os detalhes de um país com base no seu código ISO 2.
-*   **Get States by Country**: Retorna uma lista de todos os estados/províncias de um determinado país.
-*   **Get Cities by State**: Retorna uma lista de todas as cidades de um determinado estado/província.
+### 🌍 Get Country by Code
+Retorna os detalhes de um país com base no seu código ISO 2.
+- **Input**: Country Code (ex: `US`, `BR`, `CA`)
+- **Output**: Nome, código ISO, coordenadas, etc.
+
+### 🏛️ Get States by Country  
+Retorna uma lista de todos os estados/províncias de um determinado país.
+- **Input**: Country Code (ex: `US`, `BR`, `CA`)
+- **Output**: Array com todos os estados/províncias
+
+### 🏢 Get State by Code
+Retorna informações detalhadas de um estado específico.
+- **Input**: Country Code + State Code (ex: `US` + `CA`, `BR` + `SP`)
+- **Output**: Nome do estado, código ISO, coordenadas, etc.
+
+### 🏙️ Get Cities by State
+Retorna uma lista de todas as cidades de um determinado estado/província.
+- **Input**: Country Code + State Code (ex: `US` + `CA`)
+- **Output**: Array com todas as cidades
+
+## Características
+
+- ✅ **Sem API Keys**: Funciona completamente offline
+- ✅ **Rápido e Confiável**: Base de dados local, sem dependência de internet
+- ✅ **Dados Atualizados**: Usa a biblioteca country-state-city mantida ativamente
+- ✅ **Fácil de Usar**: Interface intuitiva no n8n
+- ✅ **Completo**: Suporte a todos os códigos ISO de países e estados
+
+## Exemplos de Uso
+
+### Obter informações do Brasil
+- Operation: `Get Country by Code`
+- Country Code: `BR`
+
+### Listar estados do Brasil  
+- Operation: `Get States by Country`
+- Country Code: `BR`
+
+### Obter informações de São Paulo
+- Operation: `Get State by Code`
+- Country Code: `BR`
+- State Code: `SP`
+
+### Listar cidades de São Paulo
+- Operation: `Get Cities by State`
+- Country Code: `BR`
+- State Code: `SP`
+
+## Changelog
+
+Veja [CHANGELOG.md](CHANGELOG.md) para o histórico completo de mudanças.
 
 ## Licença