diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 88d1d60..c04b615 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-    ".": "0.1.0"
+    ".": "1.0.0"
 }
\ No newline at end of file
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..1f87bb2
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,111 @@
+# Changelog
+
+## [1.0.0](https://github.com/echohello-dev/betterfit/compare/v0.1.0...v1.0.0) (2026-01-07)
+
+
+### Features
+
+* add CI/CD workflows for build and release processes ([1567675](https://github.com/echohello-dev/betterfit/commit/15676756ffe4ba8c4bf88bcf0d4079a471a23029))
+* Add core features and structure for BetterFit iOS app, including main app entry, content view, and project configuration ([fa8957e](https://github.com/echohello-dev/betterfit/commit/fa8957edbebf79cc958ae616beb1860eba53e6f5))
+* **adrs:** add ADR for Supabase authentication and data persistence strategy ([8069632](https://github.com/echohello-dev/betterfit/commit/80696325dff62c2436338bdfc297da7700a374f6))
+* **adrs:** add architecture decision records and template for documentation ([66a0424](https://github.com/echohello-dev/betterfit/commit/66a042459bd8128b649fdb2682e55b0e4a9c20f9))
+* **agent:** add Plan Agent for structured implementation planning ([5d60505](https://github.com/echohello-dev/betterfit/commit/5d6050532a53313ed2e4454ae017f480f28665f7))
+* **agents:** add philosophy section to outline coding principles ([79fb9c0](https://github.com/echohello-dev/betterfit/commit/79fb9c0053080b520adeda9c25638ab28556551c))
+* **app-search:** add settings category and detail view ([efe4925](https://github.com/echohello-dev/betterfit/commit/efe49251309709ebea8680fe5b56d2ecbc0b4158))
+* **app-search:** enhance AppSearchView with improved search bar and navigation handling ([12968a2](https://github.com/echohello-dev/betterfit/commit/12968a292c069a7fbb0d5e20aa16b1d1d9ab7853))
+* **app-search:** enhance AppSearchView with improved section layouts and search functionality ([c9471f4](https://github.com/echohello-dev/betterfit/commit/c9471f4c7a8d347b5c1a9d56c5354ce5c76a8d5d))
+* **app-search:** refactor search categories and results structure for improved organization ([a7a77fd](https://github.com/echohello-dev/betterfit/commit/a7a77fd7bbe5e384bacdb718ec511aab52d124d5))
+* **app-search:** simplify search bar implementation and enhance navigation handling ([13860f6](https://github.com/echohello-dev/betterfit/commit/13860f6db6df3addd46c2de2fff3014a0c5a6b28))
+* **app:** enhance guest mode warning with sign-in prompt ([d1f1444](https://github.com/echohello-dev/betterfit/commit/d1f144452fbb33f0b055af83d15fe07ad2a126f5))
+* **assets:** add app icon and image asset generation files for iOS and watchOS ([313d37e](https://github.com/echohello-dev/betterfit/commit/313d37ece574a589ebf8bb549590f4d4897047c7))
+* **assets:** add app icon asset catalog for iOS ([d802fbd](https://github.com/echohello-dev/betterfit/commit/d802fbd932e252940063b53b18dd222364dcef5f))
+* **assets:** add app icon images and include asset catalog in project configuration ([4badcfc](https://github.com/echohello-dev/betterfit/commit/4badcfce0eee57c79a28b8a0824f0b53940c927b))
+* **assets:** update app icon images for various resolutions ([49f80cc](https://github.com/echohello-dev/betterfit/commit/49f80cc64ab1104121e8c5b6cd860e8f82387c1d))
+* **auth:** implement Google OAuth sign-in and URL handling ([bcb6e47](https://github.com/echohello-dev/betterfit/commit/bcb6e477d448d6641c50e7ec603788f7d7b8139a))
+* **auth:** integrate user authentication and display name handling ([1f79561](https://github.com/echohello-dev/betterfit/commit/1f79561a43d21ab26e4d431aad3f81813f4c9528))
+* **betterfit:** implement active workout retrieval in BetterFit class ([40621ed](https://github.com/echohello-dev/betterfit/commit/40621ed74ef6fc9c070bc5eb87f6af33c81300c7))
+* **build:** update CI workflow to use macOS 26 for builds and tests ([a684d4d](https://github.com/echohello-dev/betterfit/commit/a684d4d5003a9a8c5336e07c59b408a7b23dcbf8))
+* **build:** update CI workflow to use ubuntu-latest for SwiftPM and macOS-latest for iOS builds ([1e9c0af](https://github.com/echohello-dev/betterfit/commit/1e9c0af1237fe2065d74d467d153beb705689f4c))
+* **docs:** add AGENTS.md for workflow and architecture documentation ([2cca638](https://github.com/echohello-dev/betterfit/commit/2cca63895fb33618a76e5714ebbfbd44b22f1a4f))
+* **docs:** add API reference and usage examples documentation ([b073c4d](https://github.com/echohello-dev/betterfit/commit/b073c4ddd1758c0da362cddeb0bc2ae763a134a5))
+* **docs:** add CONTRIBUTING.md for development setup and guidelines ([a684d4d](https://github.com/echohello-dev/betterfit/commit/a684d4d5003a9a8c5336e07c59b408a7b23dcbf8))
+* **docs:** add TabView patterns documentation for iOS 17+ and iOS 26+ ([3d086cb](https://github.com/echohello-dev/betterfit/commit/3d086cba508a08583c8c37efc25b5eed21cf4505))
+* **docs:** update README to enhance clarity and structure of core features ([95ee2b5](https://github.com/echohello-dev/betterfit/commit/95ee2b5b4c977c99d7233b5d5810d59a2da142dd))
+* **env:** streamline Supabase credential management and update project setup scripts ([848d019](https://github.com/echohello-dev/betterfit/commit/848d0193b9827ba5eb36b71b75fd03e7c1dceddd))
+* **exercise-picker:** add exercise picker view with filtering and sorting ([23720d5](https://github.com/echohello-dev/betterfit/commit/23720d59bbe0163db9493c05811b19f249b85e39))
+* **exercise:** add ExerciseDetailSheet for detailed exercise management ([f713b8f](https://github.com/echohello-dev/betterfit/commit/f713b8fe020df11d0613cdc8f174030a3c2b218e))
+* **exercise:** consolidate exercise templates into a single library ([30990ed](https://github.com/echohello-dev/betterfit/commit/30990ed7ba86e7f14151db52508eff9a9aca35c1))
+* **floating-nav-bar:** add circle background with glass effect for improved UI ([dc0f826](https://github.com/echohello-dev/betterfit/commit/dc0f8262a6afaf38eb480a59492604c87d9d92b5))
+* **floating-nav-bar:** enhance search functionality and improve tab navigation experience ([4594424](https://github.com/echohello-dev/betterfit/commit/4594424f4b29af72d8159ef39aec9dfbefd9be93))
+* **floating-nav-bar:** enhance search functionality with animated background and improved UI ([b28b10e](https://github.com/echohello-dev/betterfit/commit/b28b10e54d570d64c4dd8ac0c216b7f74f1d863b))
+* **fonts:** add custom BBHHegarty fonts to iOS and Watch app Info.plist and project.yml ([b853657](https://github.com/echohello-dev/betterfit/commit/b853657b1376795826f0f4a0d6dd131c13a63b8a))
+* **healthkit:** add HealthKit capabilities and entitlements for workout tracking ([5d16490](https://github.com/echohello-dev/betterfit/commit/5d164907a0e2464edab47d5dd17f5ce1d311a252))
+* **healthkit:** add usage descriptions for health data access ([f2842ad](https://github.com/echohello-dev/betterfit/commit/f2842ad7f3d40e005e1bd7fbac28f1f859e38f39))
+* **healthkit:** integrate HealthKit for workout tracking and health data synchronization ([d1ada19](https://github.com/echohello-dev/betterfit/commit/d1ada1954e671c67bcb9e71d048fe1f224080351))
+* **healthkit:** update HealthKit entitlements and access permissions for workout tracking ([75554f2](https://github.com/echohello-dev/betterfit/commit/75554f26a2909d0b9d3d4e9a95f94b87544215a9))
+* **iOS:** update entitlements and Info.plist for HealthKit background delivery support ([f67b635](https://github.com/echohello-dev/betterfit/commit/f67b6355900ac442fba64c9f2e733126cee9b6fa))
+* **lint:** add SwiftLint configuration and update lint task in mise.toml ([1bd2b0d](https://github.com/echohello-dev/betterfit/commit/1bd2b0d62e1ae3122bb2cc43ea274e9fa6c5dadf))
+* **mise:** add linting task and update tools section in mise.toml ([027aa56](https://github.com/echohello-dev/betterfit/commit/027aa56967bbf41b8d2d56f02927996f975f93cd))
+* **navigation:** hide navigation bar in RootTabView for improved UI experience ([6759e34](https://github.com/echohello-dev/betterfit/commit/6759e341287e5bd0d7ced611a8f145596089efb6))
+* **persistence:** implement PersistenceProtocol and SupabasePersistenceService for data management ([f6f3d85](https://github.com/echohello-dev/betterfit/commit/f6f3d852a96b698bce341564c19eca741baf89b1))
+* **persistence:** implement user-specific data handling in Supabase service and add migration scripts ([9040455](https://github.com/echohello-dev/betterfit/commit/9040455374a6452d15a7a4047d438e001958bed2))
+* **plan:** implement plan view with weekly schedule and AI suggestions ([23720d5](https://github.com/echohello-dev/betterfit/commit/23720d59bbe0163db9493c05811b19f249b85e39))
+* **preview:** add preview for StreakSummarySheetView with sample workouts ([fde2eca](https://github.com/echohello-dev/betterfit/commit/fde2ecacdc26eb7d5dd26ffb8cb671d518bb084e))
+* **profile:** add contribution heatmap and expand/collapse functionality ([216e1f2](https://github.com/echohello-dev/betterfit/commit/216e1f25a3507eec41a442c90824ce7665ca1a8d))
+* **profile:** add ProfileView for user settings and theme selection ([5a77be9](https://github.com/echohello-dev/betterfit/commit/5a77be9ebfa90e649381954f8d27758337a8dbe0))
+* **profile:** enhance profile view with demo data and health stats ([c5671d8](https://github.com/echohello-dev/betterfit/commit/c5671d8e9f294f688b4da55b7024b0af6ab72919))
+* **recovery:** implement RecoveryView to display recovery status and workouts ([5a77be9](https://github.com/echohello-dev/betterfit/commit/5a77be9ebfa90e649381954f8d27758337a8dbe0))
+* **recovery:** refactor RecoveryView to use ScrollView and enhance UI components ([fec7d72](https://github.com/echohello-dev/betterfit/commit/fec7d72ae213bb9a1e15079c60b9c79d3720733b))
+* **release:** configure release-please with manifest and config files ([4196520](https://github.com/echohello-dev/betterfit/commit/41965208e052ecb0d6c0d948bc4a465a51bde6bc))
+* **root-tab-view:** improve layout and safe area handling in RootTabView ([f67d910](https://github.com/echohello-dev/betterfit/commit/f67d910bd5f027e6951623da16d27a1ff099572d))
+* **root-tab-view:** refactor RootTabView to use enum for tabs and improve navigation structure ([0aa6a7c](https://github.com/echohello-dev/betterfit/commit/0aa6a7c13cbbdf4a76bd91234e59a85d0d675003))
+* **root-tab:** add start workout button with styling and safe area inset ([64c3ced](https://github.com/echohello-dev/betterfit/commit/64c3ced5fef75e949dbf5ca785795f5a87b4f416))
+* **root-tab:** enhance guest mode handling with Supabase configuration ([249ec92](https://github.com/echohello-dev/betterfit/commit/249ec927baca93b973b3d99ab0e3240232785134))
+* **search:** add AppSearchView and integrate search functionality across multiple views ([189a21a](https://github.com/echohello-dev/betterfit/commit/189a21a6788fcec810539a0a763e58e973e2287e))
+* **search:** integrate search functionality across multiple views and add demo mode support ([8c48835](https://github.com/echohello-dev/betterfit/commit/8c48835328e2cb0420cc573d8f3c61f510873809))
+* **simctl:** add timeout option for simulator query and improve error handling ([6dabd54](https://github.com/echohello-dev/betterfit/commit/6dabd54aaa2b8ead449d89c8c8724841f3ffeadc))
+* **skills:** add new skills for ADR writing, agent skills authoring, app icon generation, and Swift iOS teaching ([716ba48](https://github.com/echohello-dev/betterfit/commit/716ba48842d24283f2e2c6251c883efa3190c41b))
+* **skills:** add Swift & iOS teaching skill documentation for React/Next.js developers ([d9ed117](https://github.com/echohello-dev/betterfit/commit/d9ed117c32b5e56b89d182bbeaffe9409b1f6d31))
+* **social:** add last workout date retrieval in SocialManager ([40621ed](https://github.com/echohello-dev/betterfit/commit/40621ed74ef6fc9c070bc5eb87f6af33c81300c7))
+* **streak:** add StreakSummarySheetView for displaying workout streaks ([5a77be9](https://github.com/echohello-dev/betterfit/commit/5a77be9ebfa90e649381954f8d27758337a8dbe0))
+* **supabase:** add scripts for local environment setup and loading credentials ([f61d20a](https://github.com/echohello-dev/betterfit/commit/f61d20a5b5d098b5e22aeb455740725f5388144d))
+* **swift-ios-teaching:** enhance interactive teaching guidelines ([8b9c7f4](https://github.com/echohello-dev/betterfit/commit/8b9c7f47045108867f4872e6e97f6eefbb87457a))
+* **tabs:** create RootTabView to manage main navigation and tabs ([5a77be9](https://github.com/echohello-dev/betterfit/commit/5a77be9ebfa90e649381954f8d27758337a8dbe0))
+* **tabs:** replace recovery tab with profile tab and update navigation ([23720d5](https://github.com/echohello-dev/betterfit/commit/23720d59bbe0163db9493c05811b19f249b85e39))
+* **tests:** add comprehensive tests for AppConfiguration and integration tests for BetterFit functionality ([f6f3d85](https://github.com/echohello-dev/betterfit/commit/f6f3d852a96b698bce341564c19eca741baf89b1))
+* **theme:** implement theme management with multiple options and UI components ([0c153d4](https://github.com/echohello-dev/betterfit/commit/0c153d4303aa4083f67f60435e646df9442589e8))
+* **theme:** introduce ThemePickerView for selecting app themes ([5a77be9](https://github.com/echohello-dev/betterfit/commit/5a77be9ebfa90e649381954f8d27758337a8dbe0))
+* **theme:** update color gradients and add custom BBHHegarty font candidates ([6168cb5](https://github.com/echohello-dev/betterfit/commit/6168cb5eefe419365be46efc321d5010b7f8e6c3))
+* **trends:** add weekly volume and recovery trend sections with mock data ([c6fd88b](https://github.com/echohello-dev/betterfit/commit/c6fd88b95ed363e1091d047ddeea8dd178706ee9))
+* **trends:** create TrendsView with placeholder for future trend features ([5a77be9](https://github.com/echohello-dev/betterfit/commit/5a77be9ebfa90e649381954f8d27758337a8dbe0))
+* **ui:** add search functionality and improve navigation in RootTabView ([40621ed](https://github.com/echohello-dev/betterfit/commit/40621ed74ef6fc9c070bc5eb87f6af33c81300c7))
+* **uikit-swiftui-advisor:** add comprehensive guidance for UIKit vs SwiftUI usage ([10f3a2e](https://github.com/echohello-dev/betterfit/commit/10f3a2eed66224155ecdfd5de94cada67705bdd1))
+* **ui:** refactor AppSearchView and WorkoutHomeView for improved section organization and add custom heatmap range feature ([91c9d4f](https://github.com/echohello-dev/betterfit/commit/91c9d4f0f84ee7c065f7daa53d9fd5122e640ec1))
+* **ui:** replace buttons with BFChromeIconButton for consistent styling and add theme support ([87a5964](https://github.com/echohello-dev/betterfit/commit/87a5964634cefa6d0f3b1bd346f9d23d8833a1ab))
+* **vscode:** add commit message generation instructions for conventional format ([60cab27](https://github.com/echohello-dev/betterfit/commit/60cab27f44c811c6cbb8846dc5003cedd270ccf4))
+* **watch-app:** add app icons and update Info.plist for BetterFit Watch app ([af55de0](https://github.com/echohello-dev/betterfit/commit/af55de0ea68cfe6735bfb0a2780edf4539d05cbc))
+* **watch-app:** add BetterFit Apple Watch app with workout tracking and reminders ([28a872d](https://github.com/echohello-dev/betterfit/commit/28a872d150441f5733f37d9196a4ebd91ccc6b41))
+* **watch-app:** add watch app setup instructions and scripts for simulator management ([e3f7a35](https://github.com/echohello-dev/betterfit/commit/e3f7a35289996d2598612da7569691eabe245102))
+* **workout-home:** enhance streak display and auto-scroll functionality ([b1efdaf](https://github.com/echohello-dev/betterfit/commit/b1efdafc6ea1f852da5e1837c16bafa7d66025d6))
+* **workout:** add guest sign-in prompt and related functionality ([d605246](https://github.com/echohello-dev/betterfit/commit/d6052463bbeedb4494582990e96276d92eb6e734))
+* **workout:** add workout control features and UI updates ([cb0097f](https://github.com/echohello-dev/betterfit/commit/cb0097fa5b5f6f3c9d1de2165d9242fbe309d58f))
+* **workout:** add workout planning and tracking features ([6c76eb9](https://github.com/echohello-dev/betterfit/commit/6c76eb9bbdcceac35d69a945f7c0476039c838d1))
+* **workout:** enhance workout preview with static exercise timeline ([bf63941](https://github.com/echohello-dev/betterfit/commit/bf63941de876da0199d6d6c4c8472eaa82d440bc))
+* **workout:** enhance WorkoutHomeView with streak tracking and vitals display ([40621ed](https://github.com/echohello-dev/betterfit/commit/40621ed74ef6fc9c070bc5eb87f6af33c81300c7))
+* **workout:** implement workout timer and elapsed time display updates ([f514fee](https://github.com/echohello-dev/betterfit/commit/f514feecd6f05c04b15c27e9210b4025e1b0f13a))
+* **workout:** isolate workout card stack to prevent re-renders on swipe gestures ([74d412b](https://github.com/echohello-dev/betterfit/commit/74d412b6260950bad0fdc5577f662c13d82534e3))
+* **workout:** update default username to 'Guest' in WorkoutHomeView ([2d3e74b](https://github.com/echohello-dev/betterfit/commit/2d3e74bd07015bbc3783667eb35d8d942853184c))
+* **workout:** update exercise equipment requirements and muscle groups for workouts ([ab2c406](https://github.com/echohello-dev/betterfit/commit/ab2c406c719650ca66614fa5e5b34fa3d95b4cb7))
+
+
+### Bug Fixes
+
+* **agents:** update linting instructions for clarity in workflow section ([dcf5042](https://github.com/echohello-dev/betterfit/commit/dcf50425e56434a669a82615a9dbfea2c9e6e308))
+* **app:** update display name in Info.plist from 'BetterFit Dev' to 'BetterFit' ([a9d7ac5](https://github.com/echohello-dev/betterfit/commit/a9d7ac580b3611d2b710c68de1af0c80a32ceeba))
+* **auto-tracking:** improve workout tracking logic and add current workout retrieval ([40621ed](https://github.com/echohello-dev/betterfit/commit/40621ed74ef6fc9c070bc5eb87f6af33c81300c7))
+* **healthkit:** remove unnecessary HealthKit access and background delivery keys ([c5f258e](https://github.com/echohello-dev/betterfit/commit/c5f258ed5036a32002d1028a1abadeffaa5fd334))
+* **preview:** update theme in preview from forest to defaultTheme ([0f548e3](https://github.com/echohello-dev/betterfit/commit/0f548e3e2ad95091911fb717392d751964b11ea6))
+* **project:** update iOS deployment target from 26.0 to 17.0 ([c47acb2](https://github.com/echohello-dev/betterfit/commit/c47acb21dd21e2cab7f52a9e76357747531f393e))
+* **ui:** change heatmap range default from month to year in WorkoutHomeView and ensure scrolling behavior ([75554f2](https://github.com/echohello-dev/betterfit/commit/75554f26a2909d0b9d3d4e9a95f94b87544215a9))
+* **watch-app:** correct formatting and structure in Info.plist ([a3f04b6](https://github.com/echohello-dev/betterfit/commit/a3f04b60e5aaf6b4cd586cbf44b1c18c72112dd9))
+* **workout:** clean up timer logic and ensure proper invalidation ([1f63c9f](https://github.com/echohello-dev/betterfit/commit/1f63c9f69c858f33960dcbdcd1107251252ec779))