diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 000000000..e94263f95
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,139 @@
+# 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]
+
+### Added
+- (checkout-reward) Disable and hide delivery options for reward feature purchases
+- (purchase-options) Add disabledPurchaseOptions with flexible visibility control
+- (reward-catalog) Pre-select in-store option for reward purchases
+- (checkout) Complete reward order confirmation with reusable product info component
+- (checkout) Implement reward order confirmation UI and confirmation list item action card component
+- (checkout) Add reward order confirmation feature with schema migrations
+- (stock-info) Implement request batching with BatchingResource
+- (crm) Introduce PrimaryCustomerCardResource and format-name utility
+- Angular template skill for modern template patterns
+- Tailwind ISA design system skill
+
+### Changed
+- (checkout-reward) Implement hierarchical grouping on rewards order confirmation
+- (checkout) Move reward selection helpers to data-access for reusability
+- (common) Add validation for notification channel flag combinations
+- (customer) Merge continueReward and continue methods into unified flow
+- Comprehensive CLAUDE.md overhaul with library reference system
+- Add Claude Code agents, commands, and skills infrastructure
+
+### Fixed
+- (checkout) Resolve currency constraint violations in price handling
+- (checkout) Add complete price structure for reward delivery orders
+- (checkout) Correct reward output desktop/mobile layout and add insufficient stock warnings
+- (customer-card) Implement navigation flow from customer card to reward search
+- (purchase-options) Correct customer features mapping
+- (reward-order-confirmation) Group items by item-level delivery type
+- (reward-order-confirmation) Correct typo and add loading state to collect button
+- (reward-confirmation) Improve action card visibility and status messages
+- (reward-selection-pop-up) Fix width issue
+
+## [4.2] - 2025-10-23
+
+### Added
+- (checkout-reward) Add reward checkout feature (#5258)
+- (crm) Add crm-data-access library with initial component and tests
+- (shared-filter) Add canApply input to filter input menu components
+- Architecture Decision Records (ADRs) documentation
+- Error handling and validation infrastructure enhancements
+
+### Changed
+- (tabs) Implement backwards compatibility for Process → Tabs migration
+- (notifications) Update remission path logic to use Date.now()
+- (customer-card) Deactivate Create Customer with Card feature
+- Update package.json and recreate package-lock.json for npm@11.6
+- Disable markdown format on save in VSCode settings
+
+### Fixed
+- (process) Simulate "old tab logic" for compatibility
+- (tabs) Correct singleton tabs interaction with new tab areas
+- (remission-list) Prioritize reload trigger over exact search
+- (remission-list-item, remission-list-empty-state) Improve empty state handling
+
+## [4.1] - 2025-10-06
+
+### Added
+- (isa-app) Migrate remission navigation to tab-based routing system
+- (utils) Add scroll-top button component
+- (remission-list, empty-state) Add comprehensive empty state handling with user guidance
+- (remission) Ensure package assignment before completing return receipts
+- (libs-ui-dialog-feedback-dialog) Add auto-close functionality with configurable delay
+- (old-ui-tooltip) Add pointer-events-auto to tooltip panel
+
+### Changed
+- (remission-list) Improve item update handling and UI feedback
+- (remission-list, search-item-to-remit-dialog) Simplify dialog flow by removing intermediate steps
+
+### Fixed
+- (remission-list) Ensure list reload after search dialog closes
+- (remission-list) Auto-select single search result when remission started
+- (remission-list, remission-return-receipt-details, libs-dialog) Improve error handling with dedicated error dialog
+- (remission-error) Simplify error handling in remission components
+- (remission) Filter search results by stock availability and display stock info
+- (remission-list, remission-data-access) Add impediment comment and remaining quantity tracking
+- (remission-quantity-and-reason-item) Correct quantity input binding and dropdown behavior
+- (remission-quantity-reason) Correct dropdown placeholder and remove hardcoded values
+- (remission-filter-label) Improve filter button label display and default text
+- (remission-data-access) Remove automatic date defaulting in fetchRemissions
+- (remission-shared-search-item-to-remit-dialog) Display context-aware feedback on errors
+- (isa-app-shell) Improve navigation link targeting for remission sub-routes
+- (oms-data-access) Adjust tolino return eligibility logic for display damage
+- (ui-input-controls-dropdown) Prevent multiple dropdowns from being open simultaneously
+
+## [4.0] - 2025-07-23
+
+### Added
+- (oms-data-access) Initial implementation of OMS data access layer
+- (oms-return-review) Implement return review feature
+- (print-button) Implement reusable print button component with service integration
+- (scanner) Add full-screen scanner styles and components
+- (product-router-link) Add shared product router link directive and builder
+- (tooltip) Add tooltip component and directive with customizable triggers
+- (shared-scanner) Move scanner to shared/scanner location
+- (common-data-access) Add takeUntil operators for keydown events
+
+### Changed
+- (oms-return-review, oms-return-summary) Fix return receipt mapping and ensure process completion
+- (ui-tooltip) Remove native title attribute from tooltip icon host
+- (oms-return-details) Improve layout and styling of order group item controls
+- (searchbox) Improve formatting and add showScannerButton getter
+- (libs-ui-item-rows) Improve data value wrapping and label sizing
+- (shared-filter, search-bar, search-main) Add E2E data attributes for filtering and search
+
+### Fixed
+- (return-details) Update email validation and improve error handling
+- (return-details) Correct storage key retrieval in ReturnDetailsStore
+- (return-details) Small layout fix (#5171)
+- (isa-app-moment-locale) Correct locale initialization for date formatting
+- (oms-return-search) Fix display and logic issues in return search results
+- (oms-return-search) Resolve issues in return search result item rendering
+- (oms-task-list-item) Address styling and layout issues in return task list
+- (ui-dropdown) Improve dropdown usability and conditional rendering
+- (return-search) Correct typo in tooltip content
+- (libs-shared-filter) Improve date range equality for default filter inputs
+
+## [3.4] - 2025-02-10
+
+_Earlier versions available in git history. Detailed changelog entries start from version 4.0._
+
+### Historical Versions
+
+Previous versions (3.3, 3.2, 3.1, 3.0, 2.x, 1.x) are available in the git repository.
+For detailed information about changes in these versions, please refer to:
+- Git tags: `git tag --sort=-creatordate`
+- Commit history: `git log <tag-from>..<tag-to>`
+- Pull requests in the repository
+
+---
+
+_This changelog was initially generated from git commit history. Future entries will be maintained manually following the Keep a Changelog format._