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..232576d
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,122 @@
+# Changelog
+
+## [1.0.0](https://github.com/echohello-dev/betterfit/compare/v0.1.0...v1.0.0) (2026-08-09)
+
+
+### Features
+
+* add animations and polish across the app ([#8](https://github.com/echohello-dev/betterfit/issues/8)) ([8fb224b](https://github.com/echohello-dev/betterfit/commit/8fb224b54fb269794f1f7dd53062d1b80daa0ee6))
+* add CI/CD workflows for build and release processes ([0c9c588](https://github.com/echohello-dev/betterfit/commit/0c9c588c31f3944c70fb17be2bdac6b7125a9de0))
+* Add core features and structure for BetterFit iOS app, including main app entry, content view, and project configuration ([e395d90](https://github.com/echohello-dev/betterfit/commit/e395d90def2db47a90a8884bd674918b8f962b15))
+* **adrs:** add ADR for Supabase authentication and data persistence strategy ([4723e31](https://github.com/echohello-dev/betterfit/commit/4723e31bb61eebeae0e4eb23ff29eb94cfb17c31))
+* **adrs:** add architecture decision records and template for documentation ([d20848c](https://github.com/echohello-dev/betterfit/commit/d20848c171eca9393b4d02094ec5ad7a71c3ed2d))
+* **agent:** add Plan Agent for structured implementation planning ([71fe9f7](https://github.com/echohello-dev/betterfit/commit/71fe9f7d55524e90b88fdffbdcf6dfd453124541))
+* **agents:** add philosophy section to outline coding principles ([83ecfa9](https://github.com/echohello-dev/betterfit/commit/83ecfa9bab4ca7f48836fe19869e008d4bc5626e))
+* **app-search:** add settings category and detail view ([2434dce](https://github.com/echohello-dev/betterfit/commit/2434dce80412887dc529c16e9cc496693c42654f))
+* **app-search:** enhance AppSearchView with improved search bar and navigation handling ([4aa6be7](https://github.com/echohello-dev/betterfit/commit/4aa6be7e08989653732d6e42723a99a127f6e9be))
+* **app-search:** enhance AppSearchView with improved section layouts and search functionality ([dfebff4](https://github.com/echohello-dev/betterfit/commit/dfebff48974afc9cac681785b4c2b5440ca4caba))
+* **app-search:** refactor search categories and results structure for improved organization ([31bd746](https://github.com/echohello-dev/betterfit/commit/31bd74604cb9e6a7a2a63817e5cad67d4dfbcb0c))
+* **app-search:** simplify search bar implementation and enhance navigation handling ([019c005](https://github.com/echohello-dev/betterfit/commit/019c005554040c7bdb4c46d4409b12a84a4084f7))
+* **app:** enhance guest mode warning with sign-in prompt ([1919ee2](https://github.com/echohello-dev/betterfit/commit/1919ee230108814a25149fe172ef063ed2f4fb1e))
+* **assets:** add app icon and image asset generation files for iOS and watchOS ([43fc6be](https://github.com/echohello-dev/betterfit/commit/43fc6bec40af9276575466f82d67512e398536a6))
+* **assets:** add app icon asset catalog for iOS ([611e91c](https://github.com/echohello-dev/betterfit/commit/611e91cc9d90e5d4353032dc163f664016a00ef2))
+* **assets:** add app icon images and include asset catalog in project configuration ([e8c84e4](https://github.com/echohello-dev/betterfit/commit/e8c84e4769a087c5a3798b4ad88fb812c5f11770))
+* **assets:** update app icon images for various resolutions ([e4f9867](https://github.com/echohello-dev/betterfit/commit/e4f9867855e86aef24bdbd19184a456981ce279b))
+* **auth:** implement Google OAuth sign-in and URL handling ([6cc0b5e](https://github.com/echohello-dev/betterfit/commit/6cc0b5ed354abac2d12f0be840ee96eec90cb79f))
+* **auth:** integrate user authentication and display name handling ([2404b66](https://github.com/echohello-dev/betterfit/commit/2404b669343aee408218d1712dd3d51ad4eff4b1))
+* **betterfit:** implement active workout retrieval in BetterFit class ([0bca1cf](https://github.com/echohello-dev/betterfit/commit/0bca1cf2326afaec46e3aa74ce1a43af2bdef248))
+* **build:** update CI workflow to use macOS 26 for builds and tests ([6758554](https://github.com/echohello-dev/betterfit/commit/67585545a952a68f0b829c403d86b50f9f1279ab))
+* **build:** update CI workflow to use ubuntu-latest for SwiftPM and macOS-latest for iOS builds ([2edc11c](https://github.com/echohello-dev/betterfit/commit/2edc11c32cc308d66b5aa38db295a9f6a65b74ae))
+* **docs:** add AGENTS.md for workflow and architecture documentation ([7e4c7f9](https://github.com/echohello-dev/betterfit/commit/7e4c7f96524b4855c5dc72ba3a78d1e67965844e))
+* **docs:** add API reference and usage examples documentation ([5b7a0c9](https://github.com/echohello-dev/betterfit/commit/5b7a0c9e0ddf25f4ce45f14078e00680a87fe7c6))
+* **docs:** add CONTRIBUTING.md for development setup and guidelines ([6758554](https://github.com/echohello-dev/betterfit/commit/67585545a952a68f0b829c403d86b50f9f1279ab))
+* **docs:** add TabView patterns documentation for iOS 17+ and iOS 26+ ([cfc7c93](https://github.com/echohello-dev/betterfit/commit/cfc7c93db11d39850fec997ccb0d1c1c69a6f469))
+* **docs:** update README to enhance clarity and structure of core features ([e6a80be](https://github.com/echohello-dev/betterfit/commit/e6a80bec01c8dcf9c40e84e19f6ba2b64a90cfb1))
+* **env:** streamline Supabase credential management and update project setup scripts ([07652d4](https://github.com/echohello-dev/betterfit/commit/07652d497ccab9b73bc78fc49a98728c0b9063e4))
+* **exercise-picker:** add exercise picker view with filtering and sorting ([e8ccea9](https://github.com/echohello-dev/betterfit/commit/e8ccea92176a328647b98c4ba0b8b580ecd9638d))
+* **exercise:** add ExerciseDetailSheet for detailed exercise management ([6f07196](https://github.com/echohello-dev/betterfit/commit/6f0719639385f913c1f14a30d1699f244efe1e4a))
+* **exercise:** consolidate exercise templates into a single library ([e837bef](https://github.com/echohello-dev/betterfit/commit/e837beff9593b0d99013ec02baa1bcf4359aeda8))
+* **floating-nav-bar:** add circle background with glass effect for improved UI ([0d9abe9](https://github.com/echohello-dev/betterfit/commit/0d9abe92949c3304461cd73c7e222ff129c81cc0))
+* **floating-nav-bar:** enhance search functionality and improve tab navigation experience ([88e2ed7](https://github.com/echohello-dev/betterfit/commit/88e2ed7d6eb9747a8c7391420bfd7319eb7ec260))
+* **floating-nav-bar:** enhance search functionality with animated background and improved UI ([794d782](https://github.com/echohello-dev/betterfit/commit/794d7823586a549469e120f8662897bc139ab31d))
+* **fonts:** add custom BBHHegarty fonts to iOS and Watch app Info.plist and project.yml ([1b08470](https://github.com/echohello-dev/betterfit/commit/1b084709dd037016e24c0ac59cecc8e06cb7bc94))
+* **healthkit:** add HealthKit capabilities and entitlements for workout tracking ([f90bb92](https://github.com/echohello-dev/betterfit/commit/f90bb92e264169bfc08c478ea1e0c92d88b4a5a0))
+* **healthkit:** add usage descriptions for health data access ([d4fb69e](https://github.com/echohello-dev/betterfit/commit/d4fb69e0172774e97312a802e6601515d10a4820))
+* **healthkit:** integrate HealthKit for workout tracking and health data synchronization ([d7db4e1](https://github.com/echohello-dev/betterfit/commit/d7db4e11825ad6060d207d38c1403a0a7d32e425))
+* **healthkit:** update HealthKit entitlements and access permissions for workout tracking ([ec69fab](https://github.com/echohello-dev/betterfit/commit/ec69fab1d129a5f930c022af6ba4600abded75eb))
+* **ios:** align illustrations and flow to BetterFit design system ([#13](https://github.com/echohello-dev/betterfit/issues/13)) ([8d15374](https://github.com/echohello-dev/betterfit/commit/8d15374826db3b15594f59aac834467675fad666))
+* **iOS:** redesign BetterFit workout experience ([#11](https://github.com/echohello-dev/betterfit/issues/11)) ([1227aaf](https://github.com/echohello-dev/betterfit/commit/1227aaf66e4037f63d1bddcd3c73bf3d355825ea))
+* **ios:** unify vector illustration system ([#20](https://github.com/echohello-dev/betterfit/issues/20)) ([7f18e5c](https://github.com/echohello-dev/betterfit/commit/7f18e5ce03abbfa9ab5602230529e7c5e9c140de))
+* **iOS:** update entitlements and Info.plist for HealthKit background delivery support ([2515079](https://github.com/echohello-dev/betterfit/commit/251507977d24eca07874e85dc63ccbeb2460803a))
+* **lint:** add SwiftLint configuration and update lint task in mise.toml ([f6db54b](https://github.com/echohello-dev/betterfit/commit/f6db54baf91a9bad9e144cf027e42dcd8d539fba))
+* **mise:** add linting task and update tools section in mise.toml ([c6c34c2](https://github.com/echohello-dev/betterfit/commit/c6c34c2397ec63425e4c5bd8282893f91bf79d7c))
+* **navigation:** hide navigation bar in RootTabView for improved UI experience ([d629bad](https://github.com/echohello-dev/betterfit/commit/d629bad41e743336d62598b9f16ba6050040e40f))
+* **persistence:** implement PersistenceProtocol and SupabasePersistenceService for data management ([9286e90](https://github.com/echohello-dev/betterfit/commit/9286e902cb8c028c4dd1b2d47a28dacab6be4427))
+* **persistence:** implement user-specific data handling in Supabase service and add migration scripts ([5156762](https://github.com/echohello-dev/betterfit/commit/5156762df0a9e9670f520400b48ce6cbfa973f29))
+* **plan:** implement plan view with weekly schedule and AI suggestions ([e8ccea9](https://github.com/echohello-dev/betterfit/commit/e8ccea92176a328647b98c4ba0b8b580ecd9638d))
+* **preview:** add preview for StreakSummarySheetView with sample workouts ([fba3df6](https://github.com/echohello-dev/betterfit/commit/fba3df6811fba25e1b94f02a81045bfcc856f0fa))
+* **profile:** add contribution heatmap and expand/collapse functionality ([e0dc38d](https://github.com/echohello-dev/betterfit/commit/e0dc38d097d4685ca5bfbd092fe20e82af085cb4))
+* **profile:** add ProfileView for user settings and theme selection ([ed0bb78](https://github.com/echohello-dev/betterfit/commit/ed0bb784059fd61fd4b61c7dae7cbc63e125e859))
+* **profile:** enhance profile view with demo data and health stats ([11678fd](https://github.com/echohello-dev/betterfit/commit/11678fd1ac6c43d41cec7228b201d29cdbe7f1f6))
+* **recovery:** implement RecoveryView to display recovery status and workouts ([ed0bb78](https://github.com/echohello-dev/betterfit/commit/ed0bb784059fd61fd4b61c7dae7cbc63e125e859))
+* **recovery:** refactor RecoveryView to use ScrollView and enhance UI components ([85eed01](https://github.com/echohello-dev/betterfit/commit/85eed012339bf81cd97a8908898575ebc1d691a3))
+* **release:** configure release-please with manifest and config files ([a68679c](https://github.com/echohello-dev/betterfit/commit/a68679c0b018339241971ed5415eab80a1d11a79))
+* **root-tab-view:** improve layout and safe area handling in RootTabView ([440e705](https://github.com/echohello-dev/betterfit/commit/440e70505278ed206442d1b52631d4f1eff3c875))
+* **root-tab-view:** refactor RootTabView to use enum for tabs and improve navigation structure ([4f7f853](https://github.com/echohello-dev/betterfit/commit/4f7f853a27f0a950662a64ed1be97020ba72ff3c))
+* **root-tab:** add start workout button with styling and safe area inset ([83d406b](https://github.com/echohello-dev/betterfit/commit/83d406b2254648a4bc76ae5b3e17b83f977b65a2))
+* **root-tab:** enhance guest mode handling with Supabase configuration ([a1f3039](https://github.com/echohello-dev/betterfit/commit/a1f30392520b40f42db47211bb0639054b5c302b))
+* **search:** add AppSearchView and integrate search functionality across multiple views ([a18cac1](https://github.com/echohello-dev/betterfit/commit/a18cac10cc2753f6f0b1db24fcbb498c476d954c))
+* **search:** integrate search functionality across multiple views and add demo mode support ([72be88b](https://github.com/echohello-dev/betterfit/commit/72be88bb153a00770e9e91bcaf2a9ccaac33c396))
+* **simctl:** add timeout option for simulator query and improve error handling ([6fb0f46](https://github.com/echohello-dev/betterfit/commit/6fb0f46dcd6a4080d61fe7bb59bf52c9834b789a))
+* **skills:** add new skills for ADR writing, agent skills authoring, app icon generation, and Swift iOS teaching ([ce7e6d8](https://github.com/echohello-dev/betterfit/commit/ce7e6d8fdf9dbeada5d2f563ff8b5f4c63d945c1))
+* **skills:** add Swift & iOS teaching skill documentation for React/Next.js developers ([d7ed83a](https://github.com/echohello-dev/betterfit/commit/d7ed83a373d7be4db61017839b7ca80b9878c7d3))
+* **social:** add last workout date retrieval in SocialManager ([0bca1cf](https://github.com/echohello-dev/betterfit/commit/0bca1cf2326afaec46e3aa74ce1a43af2bdef248))
+* **streak:** add StreakSummarySheetView for displaying workout streaks ([ed0bb78](https://github.com/echohello-dev/betterfit/commit/ed0bb784059fd61fd4b61c7dae7cbc63e125e859))
+* **supabase:** add scripts for local environment setup and loading credentials ([d61b2e6](https://github.com/echohello-dev/betterfit/commit/d61b2e679be2c63fff27cc01871b27531b08f748))
+* **swift-ios-teaching:** enhance interactive teaching guidelines ([0a0d000](https://github.com/echohello-dev/betterfit/commit/0a0d0001a25031d0806f1a84ce69e3ce72e78ad9))
+* **tabs:** create RootTabView to manage main navigation and tabs ([ed0bb78](https://github.com/echohello-dev/betterfit/commit/ed0bb784059fd61fd4b61c7dae7cbc63e125e859))
+* **tabs:** replace recovery tab with profile tab and update navigation ([e8ccea9](https://github.com/echohello-dev/betterfit/commit/e8ccea92176a328647b98c4ba0b8b580ecd9638d))
+* **tests:** add comprehensive tests for AppConfiguration and integration tests for BetterFit functionality ([9286e90](https://github.com/echohello-dev/betterfit/commit/9286e902cb8c028c4dd1b2d47a28dacab6be4427))
+* **theme:** implement theme management with multiple options and UI components ([714d5b7](https://github.com/echohello-dev/betterfit/commit/714d5b77523c860c516392b39f8614237d3cadd0))
+* **theme:** introduce semantic color tokens, light/dark, and appearance preference ([#9](https://github.com/echohello-dev/betterfit/issues/9)) ([4554bf7](https://github.com/echohello-dev/betterfit/commit/4554bf7900cd3ecd160764daf4489aff80f2bbe7))
+* **theme:** introduce ThemePickerView for selecting app themes ([ed0bb78](https://github.com/echohello-dev/betterfit/commit/ed0bb784059fd61fd4b61c7dae7cbc63e125e859))
+* **theme:** update color gradients and add custom BBHHegarty font candidates ([8df1b14](https://github.com/echohello-dev/betterfit/commit/8df1b14711a6190a43f92b6c38fdafd8d77d6b40))
+* **trends:** add weekly volume and recovery trend sections with mock data ([c6bf38f](https://github.com/echohello-dev/betterfit/commit/c6bf38f5faae4876ea7813c37235258315287205))
+* **trends:** create TrendsView with placeholder for future trend features ([ed0bb78](https://github.com/echohello-dev/betterfit/commit/ed0bb784059fd61fd4b61c7dae7cbc63e125e859))
+* **ui:** add search functionality and improve navigation in RootTabView ([0bca1cf](https://github.com/echohello-dev/betterfit/commit/0bca1cf2326afaec46e3aa74ce1a43af2bdef248))
+* **uikit-swiftui-advisor:** add comprehensive guidance for UIKit vs SwiftUI usage ([a00a17f](https://github.com/echohello-dev/betterfit/commit/a00a17f5f6edf0cbf2c1445cb5b781e20a9b2934))
+* **ui:** refactor AppSearchView and WorkoutHomeView for improved section organization and add custom heatmap range feature ([2b6c856](https://github.com/echohello-dev/betterfit/commit/2b6c856bf7d60e7ff32e8a7064e4fd037294e189))
+* **ui:** replace buttons with BFChromeIconButton for consistent styling and add theme support ([6335047](https://github.com/echohello-dev/betterfit/commit/6335047f303783463a9be300767985eccc3e16e4))
+* **vscode:** add commit message generation instructions for conventional format ([894b8e5](https://github.com/echohello-dev/betterfit/commit/894b8e583fed99f4fed3755864a366452ddd2ecd))
+* **watch-app:** add app icons and update Info.plist for BetterFit Watch app ([912a197](https://github.com/echohello-dev/betterfit/commit/912a197cea00b2d110f92acbc166144ecbba2840))
+* **watch-app:** add BetterFit Apple Watch app with workout tracking and reminders ([68a41f4](https://github.com/echohello-dev/betterfit/commit/68a41f4e3f6bd792188604bdd59f185ebe110f90))
+* **watch-app:** add watch app setup instructions and scripts for simulator management ([333847a](https://github.com/echohello-dev/betterfit/commit/333847ae9e2e1c3ce4d5cf081d8411dd5a365b05))
+* wire Profile PRs, Yearly Wrapped, exercise replacement ([7909fc1](https://github.com/echohello-dev/betterfit/commit/7909fc1ff676c187a315886103dfa73faf1f3346))
+* **workout-home:** enhance streak display and auto-scroll functionality ([4712887](https://github.com/echohello-dev/betterfit/commit/471288725c2a117491952d9f190245f538cffadb))
+* **workout:** add guest sign-in prompt and related functionality ([f6c1a3a](https://github.com/echohello-dev/betterfit/commit/f6c1a3af434c2999cc0deeb39312aa9c7f29313a))
+* **workout:** add workout control features and UI updates ([69a1260](https://github.com/echohello-dev/betterfit/commit/69a12603e0342463384ab4f4c0db486f3a175dbd))
+* **workout:** add workout planning and tracking features ([ee142c8](https://github.com/echohello-dev/betterfit/commit/ee142c82337bc239d57b0e7af775e09f70a7f6ec))
+* **workout:** enhance workout preview with static exercise timeline ([834f22a](https://github.com/echohello-dev/betterfit/commit/834f22a2d2f7d98261a94780d78436787374bc50))
+* **workout:** enhance WorkoutHomeView with streak tracking and vitals display ([0bca1cf](https://github.com/echohello-dev/betterfit/commit/0bca1cf2326afaec46e3aa74ce1a43af2bdef248))
+* **workout:** implement workout timer and elapsed time display updates ([bce8590](https://github.com/echohello-dev/betterfit/commit/bce859066791e4386adaf10c6215b7b94ee3fe88))
+* **workout:** isolate workout card stack to prevent re-renders on swipe gestures ([4b38631](https://github.com/echohello-dev/betterfit/commit/4b386310a35ec37de2522d0f619ffa4deb0c0380))
+* **workout:** update default username to 'Guest' in WorkoutHomeView ([372c289](https://github.com/echohello-dev/betterfit/commit/372c289c2633bf3a2ccde62948c20dad163c53b0))
+* **workout:** update exercise equipment requirements and muscle groups for workouts ([ce3931d](https://github.com/echohello-dev/betterfit/commit/ce3931d9644f9f1f0272d2a99dac22badf91d376))
+
+
+### Bug Fixes
+
+* **agents:** update linting instructions for clarity in workflow section ([0e6f009](https://github.com/echohello-dev/betterfit/commit/0e6f009a9781266a7a26bf6ad7ab81d9375a3855))
+* **app:** update display name in Info.plist from 'BetterFit Dev' to 'BetterFit' ([70afe83](https://github.com/echohello-dev/betterfit/commit/70afe833bdaff06ff571af781fa586d419aafc34))
+* **art:** replace stick-figure athlete with the BetterFit mark ([#16](https://github.com/echohello-dev/betterfit/issues/16)) ([731b955](https://github.com/echohello-dev/betterfit/commit/731b9554f6e5f1594c8b6ecc49de3e51f16bcf36))
+* **auto-tracking:** improve workout tracking logic and add current workout retrieval ([0bca1cf](https://github.com/echohello-dev/betterfit/commit/0bca1cf2326afaec46e3aa74ce1a43af2bdef248))
+* **ci:** remove platform-dependent build failures ([#21](https://github.com/echohello-dev/betterfit/issues/21)) ([ff24169](https://github.com/echohello-dev/betterfit/commit/ff241694d1b1124a25ae7920d1928f288b3dcbec))
+* **design:** drop cyberpunk category gradients and decorative warm colors ([#15](https://github.com/echohello-dev/betterfit/issues/15)) ([7b9fd42](https://github.com/echohello-dev/betterfit/commit/7b9fd428891aa7254e0c38d672add63ae38e0244))
+* **healthkit:** remove unnecessary HealthKit access and background delivery keys ([0635fec](https://github.com/echohello-dev/betterfit/commit/0635fecae440f075c2fe53378a63a9fc32693c52))
+* position Start Workout button correctly in tab bar ([59c0816](https://github.com/echohello-dev/betterfit/commit/59c0816026944a719944ce152e4ef61b17f73949))
+* **preview:** update theme in preview from forest to defaultTheme ([301b1a4](https://github.com/echohello-dev/betterfit/commit/301b1a4336bb84e50dcbb5cda22296da1af57f99))
+* **project:** update iOS deployment target from 26.0 to 17.0 ([945869a](https://github.com/echohello-dev/betterfit/commit/945869a527e4559f911c33a7c7780a8cce9def0d))
+* skip HealthKit for demo workouts to prevent polluting user health data ([262d4a6](https://github.com/echohello-dev/betterfit/commit/262d4a6356ccbdf81547270e80e6218e129eb488))
+* **ui:** change heatmap range default from month to year in WorkoutHomeView and ensure scrolling behavior ([ec69fab](https://github.com/echohello-dev/betterfit/commit/ec69fab1d129a5f930c022af6ba4600abded75eb))
+* **watch-app:** correct formatting and structure in Info.plist ([a76b4db](https://github.com/echohello-dev/betterfit/commit/a76b4dbd52726c834629ea60921dce3c5f6cf65d))
+* **workout:** clean up timer logic and ensure proper invalidation ([cfd3048](https://github.com/echohello-dev/betterfit/commit/cfd304896448e94ceae14343bf7e5ff77e951ace))