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