diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..df5f59e
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,84 @@
+# Changelog
+
+## 1.0.0 (2024-02-12)
+
+
+### ⚠ BREAKING CHANGES
+
+* **config:** rename `features.max_file` to `features.large_buf`
+* **toggles:** remove indent guide toggle
+* move to variable arguments for `list_insert` and `load_plugin_with_func`
+* remove `alpha_button` function since alpha provides it's own
+* **buffer:** modularize `astrocore.buffer.comparator`
+* drop support for Neovim v0.8
+* move `astrocore.utils` to root `astrocore` module
+* remove astronvim updater and git utilities
+* move autocmds,user commands, on_key to configuration table
+* icons moved to AstroUI
+
+### Features
+
+* add `on_load` function to execute a function when a plugin loads ([254a94d](https://github.com/AstroNvim/astrocore/commit/254a94d3c188b1fd1a24952cbc61d2799171c6bc))
+* add `silent` to default keymap options ([11af187](https://github.com/AstroNvim/astrocore/commit/11af1879701539badd654206514fd1518ec6336d))
+* add `wslview` support to `system_open` ([6a79c20](https://github.com/AstroNvim/astrocore/commit/6a79c20b196aefae75ce684b051587b2585a9045))
+* add ability for `on_load` to easily just load another plugin ([ca29e21](https://github.com/AstroNvim/astrocore/commit/ca29e21c1a5ffa210fa39336126f9591f9966c5c))
+* add ability for multiple plugins to be supplied to `on_load` ([720bf6b](https://github.com/AstroNvim/astrocore/commit/720bf6b2a95eaa7433c155b040d0488a9f0bc43c))
+* add buffer utilities ([2f74a61](https://github.com/AstroNvim/astrocore/commit/2f74a61db34f6193aa4cc97e6f93682ab4858527))
+* add experimental rooter ([96eb638](https://github.com/AstroNvim/astrocore/commit/96eb6381f64b437d8abf5098e62695f106cd47df))
+* add healthchecks ([7a5b7e7](https://github.com/AstroNvim/astrocore/commit/7a5b7e7c809dc09a0a7f324a2b1571f4a2efcb64))
+* add mapping configuration and autocmds ([a45533b](https://github.com/AstroNvim/astrocore/commit/a45533b22310d2dfe603617875a98dbd7094213e))
+* add Mason utility functions ([92b40bc](https://github.com/AstroNvim/astrocore/commit/92b40bc9a5c390c8323a20862fe4e489d113ad89))
+* add polish function ([485b727](https://github.com/AstroNvim/astrocore/commit/485b72796b460eead192fd09eb8f546fca6a8c80))
+* add resession extension for AstroCore ([5217973](https://github.com/AstroNvim/astrocore/commit/52179734242211c61dbfae0efb8268ed04b535d0))
+* add types for autocompletion with `lua_ls` ([63ed189](https://github.com/AstroNvim/astrocore/commit/63ed18904ff3f0d7a761eba0f5a9da2d49bee95a))
+* add UI/UX toggle utilities ([1878654](https://github.com/AstroNvim/astrocore/commit/1878654739444f81c2e1cb43a381b4975635e0d8))
+* allow `false` to disable autocmds, commands, or on_key functions ([38991f9](https://github.com/AstroNvim/astrocore/commit/38991f940cb40cbd5fe0a3634129f9c7eca6a1a9))
+* allow `large_buf` to be set to `false` to disable detection ([ac0f0bd](https://github.com/AstroNvim/astrocore/commit/ac0f0bddfd06c77345f367e4611461e338365dfb))
+* **buffer:** add ability for `close_tab` to close a specific tabpage ([1b57b25](https://github.com/AstroNvim/astrocore/commit/1b57b25107be19250aeca9f4bede0764f94c32c9))
+* clean up rooter and add toggle function ([f22dcfe](https://github.com/AstroNvim/astrocore/commit/f22dcfe6134a5cf31f92e1dcd6538010da4ef4b1))
+* **config:** rename `features.max_file` to `features.large_buf` ([e2df9f0](https://github.com/AstroNvim/astrocore/commit/e2df9f0c037f3ccbdd65b2555761f2856ec01064))
+* make `event` function more extendable ([4708247](https://github.com/AstroNvim/astrocore/commit/4708247df2a0a01672081deb48a1b8961225a97f))
+* move astronvim specific features to configuration ([4b1a21a](https://github.com/AstroNvim/astrocore/commit/4b1a21ae4de92f2bf45f8cb506ee13955f382149))
+* move autocmds,user commands, on_key to configuration table ([a2b0564](https://github.com/AstroNvim/astrocore/commit/a2b0564f8060f4d911cc53c1e8731b4cd944e4c4))
+* move git and updater utilities ([8899cc3](https://github.com/AstroNvim/astrocore/commit/8899cc3f8cf4d2701e52c3d3ed0e6b92989964a9))
+* move to variable arguments for `list_insert` and `load_plugin_with_func` ([1c7fcd5](https://github.com/AstroNvim/astrocore/commit/1c7fcd57cbdaef0ad02109e50f6748b051b8b80e))
+* **toggles:** add `buffer_indent_guides` toggle ([515d5f3](https://github.com/AstroNvim/astrocore/commit/515d5f3083e4b350852a54a8581dd736a69c3691))
+* **toggles:** add buffer local cmp toggle ([aa3d013](https://github.com/AstroNvim/astrocore/commit/aa3d013ca06734b1596dd2aa88e91c793bffc01e))
+* use `on_load` to load which-key queue automatically ([be8c860](https://github.com/AstroNvim/astrocore/commit/be8c86010cbe178e42c9efd5f3763fec360f5559))
+* **utils:** add update_packages utility to update lazy and mason ([76eb2f7](https://github.com/AstroNvim/astrocore/commit/76eb2f7d72fed4b06955e5e8a43eff64a2612666))
+
+
+### Bug Fixes
+
+* **buffer:** fix `bd` usage when `bufnr` is 0 ([ec82070](https://github.com/AstroNvim/astrocore/commit/ec82070afdce258cfb52c1e32e40edbacc67dcd9))
+* don't schedule polish ([de74fa4](https://github.com/AstroNvim/astrocore/commit/de74fa40522bf416f0e5912b6e114cd4a0adaa85))
+* guarantee M.config always exists ([cc33dfc](https://github.com/AstroNvim/astrocore/commit/cc33dfc22ed909534282331136ae87ee0662aaa5))
+* **health:** update healthcheck ([53af950](https://github.com/AstroNvim/astrocore/commit/53af950399a6bc940012613221a849e1f805f99f))
+* localize user terminals to utilities ([4e406cc](https://github.com/AstroNvim/astrocore/commit/4e406cc95e529ddcda8e3ada043c51f288f7671d))
+* protect function lazy loading against asynchronous loops ([7e125ac](https://github.com/AstroNvim/astrocore/commit/7e125acf7bddc981cbd4d0e1f8c1fa08eee50990))
+* **resession:** only change buffers on load if cursor is in a wipe buffer ([1a1bff7](https://github.com/AstroNvim/astrocore/commit/1a1bff7da93497ea9751a4dc71cfadb99ddc4804))
+* **resession:** rename extension to `astrocore` ([771930c](https://github.com/AstroNvim/astrocore/commit/771930c9c16035c0c77ca0dda857fdb3d2826669))
+* **toggles:** immediately refresh `mini.indentscope` ([526cbc3](https://github.com/AstroNvim/astrocore/commit/526cbc3f14b75510d7236bf73557a964fcb6fe91))
+* **toggles:** update semantic_tokens_enabled to just semantic_tokens ([8f6b75f](https://github.com/AstroNvim/astrocore/commit/8f6b75fb916c8a952663112102f72485354c8140))
+* update reload function with new structure ([7f5df22](https://github.com/AstroNvim/astrocore/commit/7f5df2200898934a2606f35b3d01cd9754a2a09f))
+* **utils:** reload AstroUI as well as AstroCore ([ad12e9c](https://github.com/AstroNvim/astrocore/commit/ad12e9c3683acf09544acc1cc8d414005df377bd))
+
+
+### Performance Improvements
+
+* remove need to make deep copies ([4e677ff](https://github.com/AstroNvim/astrocore/commit/4e677ff984f099832041feb6b7d304b1388f2ff6))
+
+
+### Miscellaneous Chores
+
+* drop support for Neovim v0.8 ([3213349](https://github.com/AstroNvim/astrocore/commit/3213349bfca03934ba4bc0c33aff6321b0c1e7f2))
+
+
+### Code Refactoring
+
+* **buffer:** modularize `astrocore.buffer.comparator` ([8651582](https://github.com/AstroNvim/astrocore/commit/8651582e7324bb84118444613366829723d0725c))
+* icons moved to AstroUI ([18e9189](https://github.com/AstroNvim/astrocore/commit/18e9189574ecae363074c7d23f9729cdf7f3818f))
+* move `astrocore.utils` to root `astrocore` module ([60d9aaf](https://github.com/AstroNvim/astrocore/commit/60d9aaff0306aab978f31ffb55fc326c724ad254))
+* remove `alpha_button` function since alpha provides it's own ([484de60](https://github.com/AstroNvim/astrocore/commit/484de6051cfd9ffdb53fd967397d80836fcb846e))
+* remove astronvim updater and git utilities ([a26729d](https://github.com/AstroNvim/astrocore/commit/a26729d082123c65d4dff4fbe895a1e8cf719d3a))
+* **toggles:** remove indent guide toggle ([a063322](https://github.com/AstroNvim/astrocore/commit/a06332290c833810fd22cacf37837dce5b0a39c3))