diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6430bbac6..c638ec4b4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,70 @@
+# [0.3.0-beta.1](https://github.com/imgix/imgix-core-js/compare/v0.2.3...v0.3.0-beta.1) (2021-02-03)
+
+
+### Bug Fixes
+
+* percent encode plus signs in path components ([#223](https://github.com/imgix/imgix-core-js/issues/223)) ([a5d756e](https://github.com/imgix/imgix-core-js/commit/a5d756ec56fad92bcecfb834aaefcf01ea867e21))
+* remove ensureEven requirement ([#206](https://github.com/imgix/imgix-core-js/issues/206)) ([1007f86](https://github.com/imgix/imgix-core-js/commit/1007f86886bd7e22f46baaae0b5e67e1d3b0c218))
+* update minor or patch prior to release ([65c6f3e](https://github.com/imgix/imgix-core-js/commit/65c6f3ec6ef543981f51e2263ca36f06e7d61e8b))
+* **buildSrcSet:** ensure largest size can't be repeated ([#184](https://github.com/imgix/imgix-core-js/issues/184)) ([71a092a](https://github.com/imgix/imgix-core-js/commit/71a092a7f32a629094f54882bd5865196584ef4b))
+* **buildURL:** ensure operation is idempotent ([8c6c6f9](https://github.com/imgix/imgix-core-js/commit/8c6c6f933bd50c4c718906b3a659835185d6f938))
+* add missing variable declarations ([#121](https://github.com/imgix/imgix-core-js/issues/121)) ([851a607](https://github.com/imgix/imgix-core-js/commit/851a6075ecc3f18b74caa98ca91c73d395cb45c6))
+* deprecate domain sharding ([#39](https://github.com/imgix/imgix-core-js/issues/39)) ([1b90df3](https://github.com/imgix/imgix-core-js/commit/1b90df370f6149ca2e35ba392947112e5bb6032f))
+* ensure URL-legal, path-illegal characters are encoded ([#61](https://github.com/imgix/imgix-core-js/issues/61)) ([b89dba1](https://github.com/imgix/imgix-core-js/commit/b89dba14bb2f0f16871967e9c7c438cef96bc6a6))
+* include dpr parameter when generating fixed-width srcset ([#59](https://github.com/imgix/imgix-core-js/issues/59)) ([189d4f7](https://github.com/imgix/imgix-core-js/commit/189d4f7968617e78ca0b7ee161758b4f898b368b))
+* remove deprecated domain sharding functionality ([#42](https://github.com/imgix/imgix-core-js/issues/42)) ([66d5cd9](https://github.com/imgix/imgix-core-js/commit/66d5cd94398bbec363e4982c4d2b6bdfc73dbc40))
+* remove deprecated settings.host ([#45](https://github.com/imgix/imgix-core-js/issues/45)) ([41ef41f](https://github.com/imgix/imgix-core-js/commit/41ef41fd2da8275796c976ea0eaa8076c5b778fc))
+* throw error when certain srcset modifiers are passed zero ([#114](https://github.com/imgix/imgix-core-js/issues/114)) ([2630f96](https://github.com/imgix/imgix-core-js/commit/2630f96afb623a854fab1c87456168eb55be3a3d))
+
+
+### Features
+
+* add babel core for mocha ([1266c1a](https://github.com/imgix/imgix-core-js/commit/1266c1a7f0aa6a2e88d59ded9d88237a2abd8a1a))
+* add minimal babelrc ([3809a93](https://github.com/imgix/imgix-core-js/commit/3809a935d786d9a92a5e63b750798cba3bc12942))
+* add rollup config ([f62e8db](https://github.com/imgix/imgix-core-js/commit/f62e8db161739e079bbda067ecae898b5bc921fd))
+* add semantic-release ([ebed795](https://github.com/imgix/imgix-core-js/commit/ebed7950665325078f40f0a601ce65928c9f5c85))
+* add settings.domain argument ([#44](https://github.com/imgix/imgix-core-js/issues/44)) ([af40091](https://github.com/imgix/imgix-core-js/commit/af40091a95c1b8a2c1893de6a61aba804ab082f0))
+* add src, README to files list ([9d3bb9e](https://github.com/imgix/imgix-core-js/commit/9d3bb9e2243378797959f075f5a2e4d34fadd4af))
+* add srcset generation ([#53](https://github.com/imgix/imgix-core-js/issues/53)) ([81f38e7](https://github.com/imgix/imgix-core-js/commit/81f38e72889427b4f5e36163c1bf88be57e55eb2))
+* add srcset option parameter to buildSrcSet() method signature ([#118](https://github.com/imgix/imgix-core-js/issues/118)) ([1e5507a](https://github.com/imgix/imgix-core-js/commit/1e5507af9cd3bfe50cab3cf5cabf9f53df9b2e79))
+* add support for defining a custom srcset width array ([#110](https://github.com/imgix/imgix-core-js/issues/110)) ([84974a5](https://github.com/imgix/imgix-core-js/commit/84974a52776ad8cff8c82362d260436d7a7ee810))
+* add support for defining a custom srcset width tolerance ([#109](https://github.com/imgix/imgix-core-js/issues/109)) ([504af70](https://github.com/imgix/imgix-core-js/commit/504af7078a04163f369b4fcb5f2f391660431a63))
+* add support for defining a min and max srcset width ([#108](https://github.com/imgix/imgix-core-js/issues/108)) ([fe5f5ba](https://github.com/imgix/imgix-core-js/commit/fe5f5babca784c01f7d1cf56b85f943b17d70137))
+* add typescript declaration file for ImgixClient ([#64](https://github.com/imgix/imgix-core-js/issues/64)) ([a065ad9](https://github.com/imgix/imgix-core-js/commit/a065ad9947463d5aeecd4029fa0a791f48a70be9))
+* add validation tests ([91cc39c](https://github.com/imgix/imgix-core-js/commit/91cc39c75606ffdfe949226edbbc6c861b645eef))
+* append variable qualities to dpr srcsets ([#111](https://github.com/imgix/imgix-core-js/issues/111)) ([b52148d](https://github.com/imgix/imgix-core-js/commit/b52148db33e7e5ed4ccc37dfa46953cea8efb285))
+* create a DPR srcset when a fixed height is specified ([#215](https://github.com/imgix/imgix-core-js/issues/215)) ([628e6c7](https://github.com/imgix/imgix-core-js/commit/628e6c75c27db26e68637cd6ef867d94aafb4ac6)), closes [#177](https://github.com/imgix/imgix-core-js/issues/177)
+* drop bower.json ([#222](https://github.com/imgix/imgix-core-js/issues/222)) ([2def739](https://github.com/imgix/imgix-core-js/commit/2def7394b22a08db505b03cafa3ff5713e8804c5))
+* enforce 0.01 lower bound for widthTolerance ([#211](https://github.com/imgix/imgix-core-js/issues/211)) ([8079e75](https://github.com/imgix/imgix-core-js/commit/8079e75e9cfed62c35c562cc255815f2d8cdd013))
+* generalize test-suite transpilation ([cf49986](https://github.com/imgix/imgix-core-js/commit/cf499860951bb7496ccfe74886af324a33425d2a))
+* pull constants into separate file ([bb4b36d](https://github.com/imgix/imgix-core-js/commit/bb4b36d2063f2942b56245cb3418b3c84d971212))
+* pull validation into separate module ([a113fea](https://github.com/imgix/imgix-core-js/commit/a113fea974c331c62693af66f8a4572447aff5ad))
+* reintro renovate ([d9afcdb](https://github.com/imgix/imgix-core-js/commit/d9afcdbd2869282e818d7cc1e36ba8639eaebc28))
+* remove old interface ([7a5c1e0](https://github.com/imgix/imgix-core-js/commit/7a5c1e06b783822def4a07ed82176ce6c57d427a))
+* remove renovate (for now) ([1be0281](https://github.com/imgix/imgix-core-js/commit/1be02810d36a1e85697d866410b6b04c3e85b086))
+* require @babel/register ([c488e43](https://github.com/imgix/imgix-core-js/commit/c488e43b73c706eb9f8dd065f10a21675d8610df))
+* rewrite ix-core-js as esm ([7e98689](https://github.com/imgix/imgix-core-js/commit/7e98689b9d6250ef362eee3887e20597a40c385f))
+* run mocha with babel/register ([d5c519c](https://github.com/imgix/imgix-core-js/commit/d5c519cd4069e2f5d28e9d8260ae5c891237a298))
+* run release on beta branch ([857c864](https://github.com/imgix/imgix-core-js/commit/857c8646bd1bd128d8ed0c7013bee5862b34d740))
+* test on node version 14 ([1d8d4a5](https://github.com/imgix/imgix-core-js/commit/1d8d4a5f091349daa37fe57824296d7a236fcc8c))
+* update @babel/preset-env ([879e235](https://github.com/imgix/imgix-core-js/commit/879e235739f2375c8830c0f7a6fbb4eb5e306974))
+* update buildSrcSet test suite ([5e5d5da](https://github.com/imgix/imgix-core-js/commit/5e5d5da5daa618f45d5b538efa59abe7fb26bea7))
+* update buildURL test suite ([585bb19](https://github.com/imgix/imgix-core-js/commit/585bb19c8ca91024463f0589898342ccc554ed21))
+* update client test suite ([e238dc4](https://github.com/imgix/imgix-core-js/commit/e238dc48ef59f7604936507ca83b5e96356d7aef))
+* update package.json ([c8491e0](https://github.com/imgix/imgix-core-js/commit/c8491e0126d3f8d604c12de03d8bb47791c3201a))
+* use --experimental-modules ([4c9735d](https://github.com/imgix/imgix-core-js/commit/4c9735db404a63fc41c7b37258ca71d2626bef53))
+* use const in validators ([be3ee98](https://github.com/imgix/imgix-core-js/commit/be3ee9810fb5b88b9b965d41cfdb21367b1f71c6))
+* use const where possible/appropriate ([4c2a31d](https://github.com/imgix/imgix-core-js/commit/4c2a31d87835e40df3fca701af74e84e7c043199))
+* use crypto-js ([a41ef47](https://github.com/imgix/imgix-core-js/commit/a41ef4763c9258449b7a3ea7755d16f30753c038))
+* use explicit extensions for main, module, and browser ([#225](https://github.com/imgix/imgix-core-js/issues/225)) ([3aa5bab](https://github.com/imgix/imgix-core-js/commit/3aa5babd065e38115bd268007ca0d702ee1fb1c6))
+* use mjs file extensions with type module ([#209](https://github.com/imgix/imgix-core-js/issues/209)) ([72830c4](https://github.com/imgix/imgix-core-js/commit/72830c4531db50eb8d4b07f3b034adc58f129d3a))
+* use object spread operator ([6142e75](https://github.com/imgix/imgix-core-js/commit/6142e751097f79e9d2a123977e4279f270cc1fbc))
+
+
+### Performance Improvements
+
+* **srcset:** memoize generated srcset width-pairs ([#115](https://github.com/imgix/imgix-core-js/issues/115)) ([073d63d](https://github.com/imgix/imgix-core-js/commit/073d63d7f49717f67281f6ba3719de3e341a0fc4))
+
 # Change Log
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
diff --git a/package.json b/package.json
index fcb3fef65..8ccbdb7f4 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "imgix-core-js",
   "description": "A JavaScript client library for generating image URLs with imgix",
-  "version": "2.3.2",
+  "version": "0.3.0-beta.1",
   "repository": "https://github.com/imgix/imgix-core-js",
   "license": "BSD-2-Clause",
   "main": "dist/imgix-core-js.cjs",
diff --git a/src/constants.mjs b/src/constants.mjs
index a442ddef0..ccfb2023e 100644
--- a/src/constants.mjs
+++ b/src/constants.mjs
@@ -1,5 +1,5 @@
 // package version used in the ix-lib parameter
-export const VERSION = '2.3.2';
+export const VERSION = '0.3.0-beta.1';
 // regex pattern used to determine if a domain is valid
 export const DOMAIN_REGEX = /^(?:[a-z\d\-_]{1,62}\.){0,125}(?:[a-z\d](?:\-(?=\-*[a-z\d])|[a-z]|\d){0,62}\.)[a-z\d]{1,63}$/i;
 // minimum generated srcset width