Changelog
Version 0.4.1
2025-07-23
Added
- Comprehensive Google Analytics Tracking: Enhanced user behavior monitoring across all calculators and tools
- Event Tracking System: Detailed analytics for form interactions, button clicks, and navigation events
- Calculator Analytics: Specific tracking for salary calculator, IMI calculator, NIF validator, and all user interactions
- Navigation Analytics: Complete tracking of header navigation, mobile menu usage, and service card clicks
- Export Analytics: Monitoring of CSV exports and data downloads across all tools
- Error Tracking: Enhanced error monitoring for calculation failures and validation issues
- Sitemap Enhancement: Added missing services (IMI Calculator, Retirement Planner, Social Security) to sitemap.xml
Enhanced Analytics Features
- Form Interaction Tracking: Real-time monitoring of form field changes and user inputs
- Calculator Completion Tracking: Track successful calculations with result values and input parameters
- Navigation Behavior: Monitor user navigation patterns between tools and services
- Button Click Analytics: Comprehensive tracking of all interactive elements
- Mobile Menu Analytics: Track mobile menu usage and hamburger menu interactions
- Validation Analytics: Monitor NIF validation results and error patterns
- Export Behavior: Track when users export calculation results and in what formats
Technical Improvements
- Analytics Utility Framework: Created comprehensive `/src/utils/analytics.ts` with type-safe event tracking
- Event Categorization: Organized analytics into categories (calculator, navigation, form, export, error, validation)
- TypeScript Integration: Full TypeScript support for analytics events with proper type checking
- Performance Optimization: Efficient event tracking that doesn't impact user experience
- Error Handling: Robust error tracking system for debugging and optimization
Integration
- Multi-Calculator Support: Analytics integrated across Salary Calculator, IMI Calculator, NIF Validator
- Homepage Integration: Service card click tracking on main landing page
- Header Navigation: Complete tracking of both desktop and mobile navigation patterns
- Cross-Platform Tracking: Consistent analytics across desktop and mobile experiences
Version 0.3.6
2025-07-22
Added
- IMI Calculator: Complete Portuguese Municipal Property Tax (IMI) calculator
- Property Tax Calculations: Comprehensive IMI calculation engine with exemptions and payment schedules
- Municipal Rates Support: Municipal-specific tax rates and additional taxes for major Portuguese municipalities
- Property Valuation Estimator: Built-in property value estimation tool
- Family Exemptions: Support for own residence exemptions and dependent allowances
- Payment Options: Single payment and 3-installment payment schedules with due dates
- CSV Export: Export calculation results and comparisons to CSV format
- Navigation Integration: Added IMI Calculator to main navigation menu
- Home Page Integration: Updated home page with active IMI Calculator card
Technical Improvements
- Type System: Comprehensive TypeScript interfaces for IMI calculations
- UI Components: Enhanced Input component with size variants (sm, md, lg)
- Data Structure: Extended tax formulas JSON with IMI data for 2024-2026
- Calculation Utilities: Advanced calculation functions with validation and error handling
- Municipal Data: Integrated municipal tax rates for major Portuguese cities
- SEO Optimization: Complete metadata and structured data for IMI calculator pages
Fixed
- Hydration Issues: Resolved Next.js hydration warnings in navigation components
- TypeScript Errors: Fixed type conflicts with HTML input element properties
- ESLint Compliance: Resolved linting issues with proper type annotations
Version 0.3.5
2025-07-22
Fixed
- Build Process: Resolved TypeScript and ESLint compilation errors
- Code Quality: Fixed unused import warnings in changelog component
- React Hooks: Corrected useEffect dependency issues in Social Security Calculator
- Type Safety: Enhanced TypeScript type definitions in verification utilities
- Import System: Replaced require() imports with proper ES modules for better compatibility
Technical Improvements
- Social Security Calculator: Fixed React Hook dependency warnings with proper useCallback implementation
- Verification System: Added comprehensive TypeScript interfaces for better type safety
- Dynamic Imports: Improved import system for JSON data with proper error handling
- ESLint Compliance: Resolved all linting issues for cleaner code base
- Type Definitions: Enhanced type safety across social security verification utilities
Version 0.3.4
2025-07-22
Added
- Portuguese NIF Validator: Comprehensive tax ID number validation tool
- Real-time NIF validation with Portuguese check digit algorithm
- Entity type detection and classification (individuals, companies, organizations)
- Interactive NIF format validation and auto-formatting
- Sample NIF generation for testing purposes
- Visual validation feedback with color-coded states
- Copy to clipboard functionality
- Educational information about Portuguese NIF system
New NIF Validator Features
- Algorithm Validation: Official Portuguese check digit verification
- Entity Recognition: Automatic detection of taxpayer types
- Format Assistance: Real-time formatting as users type (XXX XXX XXX)
- Example Gallery: Clickable examples for different entity types
- Validation States: Clear success/error messaging with explanations
- Mobile Responsive: Portuguese-themed design with excellent UX
- SEO Optimized: Structured data and comprehensive metadata
Technical Improvements
- Enhanced TypeScript support with comprehensive NIF data types
- Robust validation utility functions with strict/flexible modes
- Fake NIF detection for sequential and repeated digit patterns
- Entity categorization system for different business types
- Copy-to-clipboard integration for validated NIFs
Integration
- Added NIF Validator to main navigation (desktop and mobile)
- Updated home page with active NIF Validator card
- Added `/nif-validator` route with full page layout
- Updated sitemap and SEO metadata for better discoverability
Version 0.3.3
2025-07-22
Added
- Portuguese Tax Calendar: Comprehensive tax calendar with 15+ financial events
- Interactive calendar with filtering by category and business type
- Visual urgency indicators (overdue, upcoming, importance levels)
- Summary cards showing overdue and upcoming event counts
- Tax Calendar navigation in header and home page integration
- Comprehensive JSON data for Portuguese financial obligations
New Tax Calendar Features
- Event Coverage: IRS, VAT, IRC, Social Security, IMI, IUC, Commercial Registry
- Smart Filtering: Filter by categories, business types, and importance levels
- Business Types: Support for individuals, companies, freelancers, property owners
- Visual Indicators: Color-coded urgency (overdue, 7 days, 30 days, safe)
- Direct Links: Quick access to Portuguese tax portals
- Penalty Information: Important penalty details for late submissions
- Mobile Responsive: Portuguese flag color scheme throughout
Data & Events Included
- IRS: Annual declarations, withholding tax, monthly declarations
- VAT: Monthly and quarterly declarations
- IRC: Corporate tax and Modelo 22 submissions
- Social Security: Monthly contributions and payments
- Property Tax (IMI): Annual payments and installment options
- Vehicle Tax (IUC): Annual circulation tax
- Commercial Registry: Annual accounting document submissions
- EU Trade: Intrastat declarations and customs requirements
Technical Improvements
- Added proper TypeScript support for version imports
- Fixed Turbopack HMR console errors with JSON imports
- Enhanced version generation script for TypeScript modules
- Fixed ESLint issues in privacy policy page
- Added SEO optimization and structured data for tax calendar
- Updated sitemap with tax calendar entry
Integration
- Created new route at `/tax-calendar`
- Added tax calendar components and utilities
- Implemented TypeScript types for calendar events
- Enhanced metadata generation for tax-specific pages
- Updated navigation components across desktop and mobile
Version 0.3.2
2025-05-19
Added
- Privacy Policy page with comprehensive privacy information
- Beautiful, human-readable privacy policy design
- Privacy Policy link in footer
Improved
- Privacy policy page with visual sections and icons
- Card-based layout for better readability
- Dark mode support throughout the privacy page
- Interactive elements and visual hierarchy
- Enhanced typography and color scheme
Version 0.3.1
2025-05-19
Improved
- Hamburger menu now opens with smooth transitions
- Added 300ms animation duration for menu slide effect
- Enhanced menu item hover states with color transitions
- Replaced display toggle with max-height animation for better UX
Version 0.3.0
2025-05-19
Added
- Hamburger menu for mobile navigation
- Responsive mobile menu with slide-down animation
- Mobile-friendly navigation that closes on link click
- Proper ARIA attributes for better accessibility
Fixed
- Navigation now works properly on mobile devices
- Menu responsiveness across all screen sizes
Version 0.2.4
2025-05-19
Fixed
- Fixed responsive layout issues on mobile devices
- Improved padding and spacing across all breakpoints
- Made monthly breakdown table mobile-friendly with sticky columns
- Fixed card component overflow on small screens
- Adjusted font sizes for better mobile readability
- Fixed button text truncation on mobile
Version 0.2.3
2025-05-18
Fixed
- Fixed social media image formats from SVG to PNG for better compatibility
- Updated OpenGraph and Twitter card images to use PNG format
- Fixed SocialMeta component default image format
Version 0.2.2
2025-05-18
Changed
- Updated Twitter card image format from SVG to PNG
- Added Twitter site handle for better attribution
- Improved social media metadata
Version 0.2.1
2025-05-18
Changed
- Made years dynamic in all metadata and share components
- Configured site URL to use environment variables
- Updated robots.txt to be dynamically generated
- Improved sitemap generation with dynamic URLs
Fixed
- Fixed hardcoded 2024 references to use current year
- Fixed hardcoded site URLs to use environment configuration
Version 0.2.0
2025-05-18
Added
- Automatic version tagging system with git hooks
- GitHub Actions workflow for automatic releases
- Google AdSense integration with ad components
- Version file generation script (`/scripts/generate-version.js`)
- Dynamic version display from JSON configuration
- Social media sharing components
- Open Graph and Twitter card images
- PWA support with manifest.json
- Comprehensive social metadata
- AdSense ad placement components (Banner, InArticle, Sidebar)
- ads.txt file for AdSense verification
Changed
- Enhanced Makefile with version management commands
- Updated build process to include automatic version generation
- Improved Header component to display dynamic version
- Enhanced documentation with AdSense setup guide
- Updated environment files structure for better configuration
Infrastructure
- Automatic version tagging on git push
- Git hooks for pre-push and post-commit actions
- Version tracking in multiple formats (JSON, env files)
- GitHub Actions for automated releases
Documentation
- Added Google AdSense setup guide
- Created social media implementation summary
- Added automatic tagging documentation
- Enhanced troubleshooting sections
Version 0.1.0
2025-01-18
Added
- Initial release of Portugal Tools Hub
- Salary Calculator with 2024 tax rates
- Support for IRS withholding calculations
- Social Security contribution calculations
- NHR (Non-Habitual Resident) tax comparison
- Monthly income breakdown
- Employer cost calculations
- Support for various allowances (meal, car)
- Multiple marital status options
- Annual bonus management
- Detailed tax breakdown tables
- Responsive design for mobile and desktop
- Google Analytics integration
- Google Tag Manager support
- Google Ads conversion tracking
- SEO optimizations with metadata
- Sitemap generation
- Structured data (JSON-LD)
Infrastructure
- Environment-based configuration for analytics
- Development and production environment separation
- Version tracking system
- Changelog management
Documentation
- Google services setup guide
- README with project information