diff --git a/.release-please-manifest.json b/.release-please-manifest.json
index 2be9c43..37fcefa 100644
--- a/.release-please-manifest.json
+++ b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.2.0"
+  ".": "1.0.0"
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..b7e4c00
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,300 @@
+# Changelog
+
+## [1.0.0](https://github.com/twangodev/ogis/compare/ogis-v0.2.0...ogis-v1.0.0) (2026-05-09)
+
+
+### ⚠ BREAKING CHANGES
+
+* bare template names like `gradient-arctic` no longer resolve. Callers must select a layout, e.g. `gradient-arctic-banner`, `gradient-arctic-centered`, etc. URLs using the old names will fall back to the default template.
+
+### Features
+
+* add .gitattributes to mark Caddyfile as linguist-detectable ([607a876](https://github.com/twangodev/ogis/commit/607a87664c23342933676c021d120d93340b2be4))
+* add @vitest/coverage-v8 for enhanced test coverage reporting ([a18ee26](https://github.com/twangodev/ogis/commit/a18ee26584c6eca73a1034ea11448d3a6c7e74c1))
+* add 3D card stack component and integrate into hero section ([c162f51](https://github.com/twangodev/ogis/commit/c162f51a40cf6adbce930e0656ee0d4c9afe8f68))
+* add API playground configuration and enhance CORS settings for Swagger endpoints ([6011a5e](https://github.com/twangodev/ogis/commit/6011a5eeeb226735bddabda48545a8a1b5f947f2))
+* add authentication documentation and self-hosting guide ([f646458](https://github.com/twangodev/ogis/commit/f6464588c3aa589c2cb93ba2b73b4d698c05b27e))
+* add cache size configuration with human-readable formats and safety bounds ([50422de](https://github.com/twangodev/ogis/commit/50422de87bf621ef39497200dc5f8be7c2485f7b))
+* add cache sizing options ([321599e](https://github.com/twangodev/ogis/commit/321599ef48efaa0c51db302821035ba490877f13))
+* add Caddy reverse proxy configuration for ogis service ([784bee5](https://github.com/twangodev/ogis/commit/784bee560ff5ca04aacb429c26cc8c3cd764a284))
+* add CallToAction and I18nShowcase components for enhanced user engagement and global language support ([81baf0b](https://github.com/twangodev/ogis/commit/81baf0b2875935d0d4f89e3903cbffe280cfff62))
+* add Clippy linting step to CI workflow ([0405450](https://github.com/twangodev/ogis/commit/0405450e7eec6b9e9234a35abaa152614cb2a6d9))
+* add Codecov token to GitHub Actions workflow for coverage upload ([203e2f0](https://github.com/twangodev/ogis/commit/203e2f0fb299d8c19cf99a5b65d4bb524d5c4397))
+* add color customization support for templates with validation ([fc68375](https://github.com/twangodev/ogis/commit/fc683757dad5dcaebcedd7f491cbceeb99437d2f))
+* add color customization support for templates with validation ([498a4a5](https://github.com/twangodev/ogis/commit/498a4a5417230f9b9a97f2d06554301981726cc4))
+* add configurable server address for Open Graph Image Service ([56147f6](https://github.com/twangodev/ogis/commit/56147f67caf3244917a41f6143e495b52e2ba7c0))
+* add contextual options and icons to documentation files ([9afe6a3](https://github.com/twangodev/ogis/commit/9afe6a3eddc476f97f7f2582e36d140ad94cf242))
+* add CORS support for documentation endpoints with configurable origins ([db6d067](https://github.com/twangodev/ogis/commit/db6d0671a877b21cf8dc043e11dcbedfd5958f3c))
+* add dark and light SVG icons for improved UI consistency [skip-ci] ([98d30e8](https://github.com/twangodev/ogis/commit/98d30e8d8f1ed0a734b726988830943ec7634300))
+* add dark and light SVG icons for improved UI consistency [skip-ci] ([4660f15](https://github.com/twangodev/ogis/commit/4660f15a33bfe64a5802db4229305378ff453b61))
+* add default title, description, and subtitle configuration for Open Graph images ([d8fbf87](https://github.com/twangodev/ogis/commit/d8fbf8781f347e54eadbe370f2715c1dc23e07fe))
+* add demo ([30af1a8](https://github.com/twangodev/ogis/commit/30af1a857ff826dab34928680ebcbcad3b638cf5))
+* add Docker build and push workflow to CI pipeline ([f91f412](https://github.com/twangodev/ogis/commit/f91f412b8f6a4cd5aa2f552c3466782e0acd4462))
+* add Docker support with docker-compose and enhance Dockerfile for health checks ([f94f088](https://github.com/twangodev/ogis/commit/f94f08818571cea0a2e69a5a49194e09b09ab1b4))
+* add Docker support with Dockerfile and .dockerignore ([913fb75](https://github.com/twangodev/ogis/commit/913fb75bf66335ccd28fc9f348af8327026f81ea))
+* add dotenvy support for environment variable management ([4e9177d](https://github.com/twangodev/ogis/commit/4e9177d5afbe24dfc7db579ef352e5fbe7e30ba7))
+* add dotenvy support for environment variable management ([a246468](https://github.com/twangodev/ogis/commit/a246468d43373d2bcd466235f1e076cc3adb4c6a))
+* add dual theme support for syntax highlighting with Shiki ([0d129a9](https://github.com/twangodev/ogis/commit/0d129a9bbb0781ded7794f79921a7e2b538073f0))
+* add fish template with color configurations and SVG file reference ([987b52e](https://github.com/twangodev/ogis/commit/987b52e9bc6d55aa506502d72bd1133cc331129e))
+* add fish.svg graphic with placeholder elements and gradients ([c51bf1b](https://github.com/twangodev/ogis/commit/c51bf1b3b39671f567899727614b8da878be4922))
+* add flags for Codecov in CI configurations for Rust and TypeScript ([0f00b4e](https://github.com/twangodev/ogis/commit/0f00b4e51051207782529072fe93efffb3d1153f))
+* add font loading functionality with YAML configuration ([822744b](https://github.com/twangodev/ogis/commit/822744b1528f380b207f48709c80fb303bfc84b3))
+* add GitHub Actions workflow for code coverage with Codecov integration ([f599930](https://github.com/twangodev/ogis/commit/f599930f891a7f7993413462e4c80123f0fcdfc6))
+* add GitHub Actions workflow for code coverage with Codecov integration ([9189e29](https://github.com/twangodev/ogis/commit/9189e29b1da159a5292891d543a044e1e28b0ab4))
+* add GitHub Actions workflow for Rust formatting and building ([a410917](https://github.com/twangodev/ogis/commit/a41091742c262ff9ef5e5e75c6a0d5b467a6bb86))
+* add GitHub Actions workflow for TypeScript linting, building, and testing ([1225c45](https://github.com/twangodev/ogis/commit/1225c450de26a65ec87bbec6535203f88b4f4894))
+* add GitHub link to Navigation and update ThemeToggle button ([a931651](https://github.com/twangodev/ogis/commit/a931651375d9859dd2ea5a3028ea637fc1eae7c5))
+* add health check and Open Graph image generation endpoints ([ca16b18](https://github.com/twangodev/ogis/commit/ca16b1852166c0b311e6e93811332bf059c851e2))
+* add health check endpoint and update API documentation ([092a2c9](https://github.com/twangodev/ogis/commit/092a2c96f0c433903c4d035d525b20ad9cf20cdd))
+* add histogram buckets for duration metrics to improve granularity ([afe196d](https://github.com/twangodev/ogis/commit/afe196dff386b254263d21fb87820f212dd4a898))
+* add HMAC authentication middleware for request validation ([99fdf6b](https://github.com/twangodev/ogis/commit/99fdf6b0494da3771054aa8db8dfc803984fd3db))
+* add HMAC authentication secret key example to .env.example ([f54dfa6](https://github.com/twangodev/ogis/commit/f54dfa6ea8fac554b95d72d1e031ea9833396834))
+* add HMAC authentication settings with secret key management ([e1252c3](https://github.com/twangodev/ogis/commit/e1252c38147fc05f358e5838848afe16ab8ead74))
+* add HMAC module and middleware exports ([ba8090a](https://github.com/twangodev/ogis/commit/ba8090a41ee29359ef729af7d5775a9547e0835b))
+* add HMAC signature field to parameters for authentication ([39a8141](https://github.com/twangodev/ogis/commit/39a8141ecadb9cd5ec462bff2472e52ab6b2835b))
+* add HMAC validator initialization based on configuration ([2897858](https://github.com/twangodev/ogis/commit/289785811d92005587917c02d15c798f60de0ad5))
+* add icons to documentation groups for improved navigation ([0c543f0](https://github.com/twangodev/ogis/commit/0c543f0d2d67ed0c5817a1c5f87415160b556868))
+* add image fallback behavior configuration for logo fetching ([9dbf080](https://github.com/twangodev/ogis/commit/9dbf08056311e827cbe6e57ce914acf7c034aad9))
+* add k6 and comparisons directories to linguist-documentation ([e5f339b](https://github.com/twangodev/ogis/commit/e5f339bcbdcab5ff6b076709e17324bfd1a33a1f))
+* add layout and navigation components with initial documentation pages ([7887985](https://github.com/twangodev/ogis/commit/78879856ee685ee9c6e31731a96d3670b4c31e59))
+* add layout components including Navigation, Footer, HeroContent, and LogoMarquee ([5da78e6](https://github.com/twangodev/ogis/commit/5da78e63885f299380ab703cd5c068ccea1661eb))
+* add light/dark logos ([f3807bf](https://github.com/twangodev/ogis/commit/f3807bf6bc3b9dee00cec50b21b08b54b280b036))
+* add Link component and update Footer with external links ([7911497](https://github.com/twangodev/ogis/commit/79114979b4f86dbe055fd2260f2e4394dba1c013))
+* add logo fetching functionality with SSRF protection and configurable timeouts ([32f8ea7](https://github.com/twangodev/ogis/commit/32f8ea7711240a4e2bcb096d6124337277f7453c))
+* add maximum input length configuration and validation for input parameters ([38cf50a](https://github.com/twangodev/ogis/commit/38cf50a5b4577c6f7b2250b4842216e409d3bb27))
+* add MCP configuration for Svelte integration ([9362b6a](https://github.com/twangodev/ogis/commit/9362b6abeca555d127d237aa98b11b3d17cb666c))
+* add metrics export interval configuration for OpenTelemetry ([1160bd3](https://github.com/twangodev/ogis/commit/1160bd3cc4c107459ac0a66203e8b51baf1641aa))
+* add middleware to record HTTP request metrics for improved telemetry ([f6d3307](https://github.com/twangodev/ogis/commit/f6d33077daf2977d704dd89fff31e83aa208165c))
+* add new entries to CardStack with updated titles, descriptions, and logos ([96882c6](https://github.com/twangodev/ogis/commit/96882c65775315448802f25103bd21965a56b7a5))
+* add new gradient SVG files and update gradient image references in README ([620125f](https://github.com/twangodev/ogis/commit/620125f64cdbebceed7dae70f547e0c3844805de))
+* add new gradient SVG files for enhanced visual variety ([d05cb1c](https://github.com/twangodev/ogis/commit/d05cb1cf79bbe0901b2d0e89d809e43b488772c5))
+* add new gradient templates including autumn, champagne, citrus, cobalt, coral, dusk, frost, noir, sahara, tropics, velvet, and wine ([b83e42a](https://github.com/twangodev/ogis/commit/b83e42aa9f5dcd89c26c14c579e7488c6b0bb3f1))
+* add new pages for Documentation, Playground, Showcase, and Templates ([11e9bd8](https://github.com/twangodev/ogis/commit/11e9bd81d18e36a931da22777ad5d952ed0cb05e))
+* add new SVG templates for enhanced design options ([e56ff32](https://github.com/twangodev/ogis/commit/e56ff32b5c2d1d89029ed2064e9d63796f82e8a9))
+* add new SVG templates for enhanced design options [skip ci] ([20d3c3a](https://github.com/twangodev/ogis/commit/20d3c3afde0f596f78360d9844745118eb76fe0b))
+* add Open Graph image generation endpoint with SVG to PNG rendering ([a9e4eb2](https://github.com/twangodev/ogis/commit/a9e4eb252295a87c94a4e7a6ff636c2b0641e681))
+* add OpenAPI specification and update API reference path ([1cda9e0](https://github.com/twangodev/ogis/commit/1cda9e0f9669557a80ba718eef8b1e896c848a23))
+* add option to export OpenAPI specification as JSON ([e630504](https://github.com/twangodev/ogis/commit/e630504f12cc31116a800501ddbf9d79cb83c7b6))
+* add output settings component for image rendering options ([123f375](https://github.com/twangodev/ogis/commit/123f375e6bb6436171e04d6a4f6652188f80dc52))
+* add params support to CardStack and OGCard for dynamic image generation ([3b91450](https://github.com/twangodev/ogis/commit/3b9145003b5d5529f96694907ee7b150fb355141))
+* add query parameter support for Open Graph parameters ([9e93290](https://github.com/twangodev/ogis/commit/9e9329093eab1720252a58eb56d1a740668563e7))
+* add refresh interval of 15 seconds to grafana overview configuration ([b74d804](https://github.com/twangodev/ogis/commit/b74d804c9045c8efee451c6db2ea096824ee09a9))
+* add sample ratio validation and improve metric descriptions ([5d00b15](https://github.com/twangodev/ogis/commit/5d00b154fe35b18e4e1a91b71c021abf317abb8c))
+* add scale bucket telemetry for image rendering ([a127901](https://github.com/twangodev/ogis/commit/a127901a2ec0d0c325e6120ff23310bc70fba44f))
+* add search functionality for template selection and integrate auto-animate for smoother UI transitions ([11d0fb2](https://github.com/twangodev/ogis/commit/11d0fb2ff4b77c9851de72ac9a4095314b9e61b9))
+* add secret generator component for HMAC secret creation in authentication documentation ([94600d4](https://github.com/twangodev/ogis/commit/94600d45690259bd524292b667ba7cdcded11d7c))
+* add self-hosting documentation and update navigation links ([302e1ac](https://github.com/twangodev/ogis/commit/302e1acbc9cd50b89b39d088b3e642aadafaa366))
+* add server URL for Open Graph image generation ([b58b647](https://github.com/twangodev/ogis/commit/b58b64720a9c65807372f2cb553c41528e3f30e1))
+* add ServerTiming and CacheableDuration for enhanced performance metrics ([#83](https://github.com/twangodev/ogis/issues/83)) ([ba3aee0](https://github.com/twangodev/ogis/commit/ba3aee0448cc96f23dba08556d9d954576c3212c))
+* add service status link to Footer and include new logo SVG ([d46734f](https://github.com/twangodev/ogis/commit/d46734f23a073a1f9993249a0b02653da82ca271))
+* add shuffle functionality for template selection and enhance UI layout ([e713224](https://github.com/twangodev/ogis/commit/e7132241d96b3316ec159af6dc3d52e5450dcbeb))
+* add step to update Docker Hub description in CI workflow [skip ci] ([b335942](https://github.com/twangodev/ogis/commit/b33594260d3fb6d2a0df30cb9e155f9329d15604))
+* add subtitle and image fields to types for enhanced template customization ([237f485](https://github.com/twangodev/ogis/commit/237f485c4849ce1cac0723b51a4ab3a39263d7a2))
+* add support for allowing HTTP URLs in logo fetching configuration ([ffb3b2a](https://github.com/twangodev/ogis/commit/ffb3b2a1da56acd0b0b19cd55fe2fb076fdddc81))
+* add SVG event handling for start, end, and empty tags with replacement strategies ([ae8e218](https://github.com/twangodev/ogis/commit/ae8e218b823205516c70bc466d086b7551301f07))
+* add SVG template and integrate quick-xml for dynamic generation ([3bead01](https://github.com/twangodev/ogis/commit/3bead01e0e1ae958907fb4f3deac9cb3e1ee1c0f))
+* add Swagger UI integration for API documentation page ([2fbecd0](https://github.com/twangodev/ogis/commit/2fbecd0c34c7fb1e03baa222a4a989fb4cc04b3f))
+* add template loading functionality and new daybreak SVG template ([f65d1a5](https://github.com/twangodev/ogis/commit/f65d1a5aaf6ef5612bd1a4c9d8abd52f78442a41))
+* add template loading functionality and new daybreak SVG template ([1dadeae](https://github.com/twangodev/ogis/commit/1dadeae3b19af2650b3b7f9bd406dff2f1cd08f8))
+* add template showcase components including TemplateCard, TemplateCategory, and TemplateMarquee ([5a5d5fb](https://github.com/twangodev/ogis/commit/5a5d5fbe428d273b44139256af6ecd922b914698))
+* add tests for template font retrieval and width constraints ([e5c1c29](https://github.com/twangodev/ogis/commit/e5c1c29d040415405712375a627a84d23090d61d))
+* add text overrides and truncation settings for reddit template ([d669074](https://github.com/twangodev/ogis/commit/d66907419e93d6b4fb108b057756884326b76b77))
+* add Thai and Hebrew font support with corresponding licenses ([e20924e](https://github.com/twangodev/ogis/commit/e20924e14882c0b4d515f7c2be7a2cb515085576))
+* add theme toggle functionality and integrate mode-watcher ([8fc0900](https://github.com/twangodev/ogis/commit/8fc090068e81fbc5008f04e18d0105340e0195bc))
+* add total requests panel and adjust grid positions for improved metrics layout ([10ebc36](https://github.com/twangodev/ogis/commit/10ebc3668e4af1c83f45928bebc972c0e7d8caba))
+* add tracing support for logging in the Axum server ([c54d6ea](https://github.com/twangodev/ogis/commit/c54d6ea54852e1c2653c8305eb8f102202e3ef47))
+* add unit tests for ApiError handling and validation scenarios ([17416e0](https://github.com/twangodev/ogis/commit/17416e0c607d3ad5eb19c6903484de5495ad5103))
+* add usage instructions for Caddyfile to clarify domain setup [skip ci] ([319e31a](https://github.com/twangodev/ogis/commit/319e31a949e8fda5f0815cafd1551c1d29bf0ce3))
+* add validation for extra parameters in params.rs with unit tests ([ce8875f](https://github.com/twangodev/ogis/commit/ce8875fba72219d13367c777297b7cb273534532))
+* add validation tests for format, scale, and quality parameters ([b224e19](https://github.com/twangodev/ogis/commit/b224e1924da2f42dd0e18e9b5da2e1393835d623))
+* add web analytics script to layout ([d83ca19](https://github.com/twangodev/ogis/commit/d83ca196b8a50526f40ea26b2ee6a28c1526d1b1))
+* add web analytics script to layout ([561de1d](https://github.com/twangodev/ogis/commit/561de1d2e95e90772fec6ee4038a0994eb1c74f3))
+* add website link to footer in documentation configuration ([83b975c](https://github.com/twangodev/ogis/commit/83b975ccbbcd282aaa96b3876af442c95089fbe7))
+* advanced templating with layouts ([#138](https://github.com/twangodev/ogis/issues/138)) ([9b25bc1](https://github.com/twangodev/ogis/commit/9b25bc1eee365eb0e0641d584cf0cd6b9ef7a7b5))
+* bump version to 0.1.1 in package.json ([ba77883](https://github.com/twangodev/ogis/commit/ba77883cf55687471f474f65d72a8ed38105fbba))
+* bump version to 0.1.2 in package.json ([c966994](https://github.com/twangodev/ogis/commit/c96699478cf059961fedc1be7538f6f7efd41a30))
+* bump version to 0.2.0 for upcoming release ([ad63aaa](https://github.com/twangodev/ogis/commit/ad63aaa1add1ba9f58914ed4b9a2249d2d75bf7c))
+* cache rendered gradient backgrounds as pixmaps ([#177](https://github.com/twangodev/ogis/issues/177)) ([380210a](https://github.com/twangodev/ogis/commit/380210abecc2b4ec6ba4b70ad91150e299c297fd))
+* clarify OTLP endpoint documentation in OpenTelemetry settings ([181672b](https://github.com/twangodev/ogis/commit/181672bff6442b1419b538c22f547ec38840db27))
+* clean up code formatting and improve readability in SVG generation ([38a1fac](https://github.com/twangodev/ogis/commit/38a1fac0f94500ca211438f3327b3568399ce714))
+* **config:** add gradient cache budget and warm-up template list ([73ff36e](https://github.com/twangodev/ogis/commit/73ff36ea12eb13008c0e2357e675a41bd21b95af))
+* configure GitHub Actions for web deployment to GitHub Pages ([bb01ebb](https://github.com/twangodev/ogis/commit/bb01ebb8ab45349ae4b4361301cbc85b851cafb2))
+* configure HTTP client with connection and request timeouts ([d77f391](https://github.com/twangodev/ogis/commit/d77f391ff198af6d4327bfedac64d0732bd35dbe))
+* construct gradient cache and run warm-up off the boot path ([f8fcf18](https://github.com/twangodev/ogis/commit/f8fcf186c8f195071131734fc37b01804416224a))
+* document HMAC authentication implementation in CLAUDE.md ([9df3769](https://github.com/twangodev/ogis/commit/9df3769d97ee37f2cfa68e59f4db7b6264fbc355))
+* enhance card components with image and template properties for improved content display ([9563376](https://github.com/twangodev/ogis/commit/95633762c9df66a9cffe9f3ac099d25d6a5d3811))
+* enhance documentation for authentication, self-hosting, and usage examples ([9decad1](https://github.com/twangodev/ogis/commit/9decad12f9093b4aa1892e991c8513db30407432))
+* enhance error responses for invalid input and authentication issues ([76cfdbe](https://github.com/twangodev/ogis/commit/76cfdbed979d79e3ce85259f34080293420a768e))
+* enhance fish.svg with additional waveform elements ([f7d9f3a](https://github.com/twangodev/ogis/commit/f7d9f3a3ad5218f50c12520170d1e73c148da721))
+* enhance fish.svg with new gradients and noise filters; update templates.yaml for gradient colors ([0a7311d](https://github.com/twangodev/ogis/commit/0a7311d78609a917c0c92eb3f16a8caec22cb3f1))
+* enhance HMAC query string builder with URL encoding and injection prevention tests ([4595a20](https://github.com/twangodev/ogis/commit/4595a20bc617b9f383ccf4c7568667b952490035))
+* enhance image handling with rounded corners and MIME type detection ([9caddc7](https://github.com/twangodev/ogis/commit/9caddc718c4b0b41c3a1c6caefe29bf1d96bc0ee))
+* enhance metrics with exponential histogram views for better data representation ([53f81f6](https://github.com/twangodev/ogis/commit/53f81f68ba85e6fb8eff5a8b5ea8de590f276318))
+* enhance PerformanceChart with dynamic latency and throughput metrics, add README for benchmarks ([903cd6a](https://github.com/twangodev/ogis/commit/903cd6a8e8d9bc1704cbdf7c996bdccf9e223f1a))
+* enhance render duration metrics with additional quantiles and new visualizations ([6b7c954](https://github.com/twangodev/ogis/commit/6b7c954131da92b51b4279738e164a132d4881b9))
+* enhance scale validation with customizable max_scale parameter ([a51f50a](https://github.com/twangodev/ogis/commit/a51f50a48cc94f9c602a4028a42c89f8570251fb))
+* enhance SVG generation with logo and subtitle support ([f19eb28](https://github.com/twangodev/ogis/commit/f19eb28250f8a40970d993f0ad153bbc0443444a))
+* enhance SVG rendering by loading system fonts ([2954f7d](https://github.com/twangodev/ogis/commit/2954f7daa0be6ee2d6d25ec862cadbb56398b0f7))
+* enhance TemplateMarquee layout and description for improved clarity and aesthetics ([be14ad3](https://github.com/twangodev/ogis/commit/be14ad3b28afebb6aabdcfdc09575c301dc92795))
+* ensure color overrides are stored in lowercase format ([b1faa18](https://github.com/twangodev/ogis/commit/b1faa18bb985e2a76a7609f8cb8cd05e022c6eab))
+* ensure scaled dimensions are at least 1 pixel in image rendering ([6d8b412](https://github.com/twangodev/ogis/commit/6d8b412d1eccd6a1d4672410e88061cae50b0181))
+* fix color override insertion to use to_string for keys ([1c1798b](https://github.com/twangodev/ogis/commit/1c1798b966d4ecd00936f0107b9e412c5908f664))
+* font fallback for other languages ([dde3a01](https://github.com/twangodev/ogis/commit/dde3a0138062407548538d3902eb3356d29ae6dc))
+* **generator:** add gradient pixmap cache with single-flight rendering ([291a6b8](https://github.com/twangodev/ogis/commit/291a6b872a1483781b1e8add40bc00361a4e8d09))
+* implement "Show more" dialog for template selection and enhance visibility of initial templates ([988cefd](https://github.com/twangodev/ogis/commit/988cefd1c85e8a4b2ed1f135e053646983f4e4ef))
+* implement basic Axum server with a ping route ([f62a514](https://github.com/twangodev/ogis/commit/f62a5145a0135a623f238c7b488416f189887212))
+* implement cycling card display in 3D card stack component ([4226630](https://github.com/twangodev/ogis/commit/422663091260b7e38cc86799a06dd5146024177e))
+* implement debounced API URL for improved preview performance ([6fe2ce6](https://github.com/twangodev/ogis/commit/6fe2ce68f5667f91d20645ede61268c4d91bd213))
+* implement default event handling for SVG with skipping logic ([44b626e](https://github.com/twangodev/ogis/commit/44b626ef0a1a5f9313fbd758ad09a1f9345dac7f))
+* implement default values for TextWidthConstraints struct ([2ca70c0](https://github.com/twangodev/ogis/commit/2ca70c0fbf7df93eb67d2cf708f1d3bd082f5418))
+* implement filter_text_overrides function and add unit tests for validation ([d3b2bc1](https://github.com/twangodev/ogis/commit/d3b2bc1515cff007501878991b1770824f141822))
+* implement format and scale optimizations for web preview and playground ([16518d2](https://github.com/twangodev/ogis/commit/16518d2d6cd73e7d7571a8d2e183fd097cdb307a))
+* implement handlers for XML events including start, end, default, and empty elements ([60cb0b7](https://github.com/twangodev/ogis/commit/60cb0b737b73c59eec7a6171acec7fcf90559acd))
+* implement hmac based authentication ([e708c07](https://github.com/twangodev/ogis/commit/e708c0740fbf3daf3daa34aa3664124d32c03cd5))
+* implement HMAC validation for query parameters ([8d5594c](https://github.com/twangodev/ogis/commit/8d5594c842565a548320add3e592fb413880f887))
+* implement image fetching with SSRF protection, caching, and base64 encoding ([44ba712](https://github.com/twangodev/ogis/commit/44ba71229df5c2ed11bd668d3fff6b207d63cc75))
+* implement image rendering with support for multiple formats and validation options ([8550fa8](https://github.com/twangodev/ogis/commit/8550fa8089bb60f033d1ccb6b45d67f628963c01))
+* implement image rendering with support for multiple formats and validation options ([2f1da49](https://github.com/twangodev/ogis/commit/2f1da49d929e9c256363593ace1070ebe134ff35))
+* implement image replacement strategy for SVG elements with <rect> bounds ([7f306bb](https://github.com/twangodev/ogis/commit/7f306bb51a702537f4354401381a881251b9e8f6))
+* implement Open Graph image generation with Swagger UI documentation ([ac685f9](https://github.com/twangodev/ogis/commit/ac685f9c99aea57be1c3fff5d3cdc958b1461d1c))
+* implement playground components for template selection, content editing, media inputs, and color customization ([5b2aa7f](https://github.com/twangodev/ogis/commit/5b2aa7fa896fb45156ffdc41f04ec4c8d6fe4726))
+* implement request logging and error handling for image fetching ([cd60390](https://github.com/twangodev/ogis/commit/cd60390b281023d29c900c97eeaea9e08353b41d))
+* implement structured error handling with ApiError and Generator Error types ([136c18d](https://github.com/twangodev/ogis/commit/136c18d66a4b18a7020b374132755fd20b907f2a))
+* implement structured error handling with ApiError and GeneratorError types ([284e26f](https://github.com/twangodev/ogis/commit/284e26f4afdda9ad576e071580f668270bdff97d))
+* implement SVG event handling with support for self-closing and closing tags ([d61aae4](https://github.com/twangodev/ogis/commit/d61aae4a40d41e963ad9305b0378f50e1b58f2e4))
+* implement template loading and integration in layout; update components to utilize new template structure ([2d62230](https://github.com/twangodev/ogis/commit/2d622300bee622c932caeb6e1cffd4d1199c7ae9))
+* implement text truncation and font property handling for templates ([66242f1](https://github.com/twangodev/ogis/commit/66242f1ae6aa104e8e722f2036f0d73a22774029))
+* implement text truncation and font property handling for templates ([#38](https://github.com/twangodev/ogis/issues/38)) ([a137219](https://github.com/twangodev/ogis/commit/a13721962eb57a209b0768a5a077a285d20e971c))
+* import Hero component and animated button with responsive design ([6865e91](https://github.com/twangodev/ogis/commit/6865e913047a45a6a68dc92f9a13bb0724d8d611))
+* improve benchmarking ([#81](https://github.com/twangodev/ogis/issues/81)) ([f9e97fa](https://github.com/twangodev/ogis/commit/f9e97fad0c84552fd7dff30a949b309ef06fd29e))
+* improve code readability and structure by reordering imports and simplifying validation logic ([56bb0a3](https://github.com/twangodev/ogis/commit/56bb0a382de85097d6e2de030866bbee038ff24b))
+* improve code readability by formatting function arguments and reordering imports ([2e62365](https://github.com/twangodev/ogis/commit/2e623652f2b47646ee6479bdbd29a2effda06366))
+* improve HMACSettings to ensure non-empty secret for authentication ([064dc69](https://github.com/twangodev/ogis/commit/064dc6983d34e7d8a649dde09669f8ccd96ca6d9))
+* improve readability of URL parsing and telemetry guard shutdown logic ([2043111](https://github.com/twangodev/ogis/commit/2043111bf643db5f848b2f9ad613a08cdcf3d732))
+* include default templates and fonts in Docker image ([fe392f9](https://github.com/twangodev/ogis/commit/fe392f935b684b233f066d2a811a801190998bc2))
+* initialize demo SvelteKit project with basic structure and configuration files ([5474271](https://github.com/twangodev/ogis/commit/54742711180cf5cae1c8239b6b2ac5783f464c64))
+* initialize ogis TypeScript client with HMAC support and utility functions ([d73ce76](https://github.com/twangodev/ogis/commit/d73ce7628fef14b786f51b0e19fff33f90123627))
+* initialize shadcn-svelte ([20c0ee1](https://github.com/twangodev/ogis/commit/20c0ee197b8ce5bd455b6609aa4dcbc24bc9e594))
+* integrate cargo clippy ([70dace4](https://github.com/twangodev/ogis/commit/70dace44cfb729b937643f807c7e53451fbcec3e))
+* integrate Cloudflare stats fetching and display in Hero component ([7427a1b](https://github.com/twangodev/ogis/commit/7427a1b8c1645edde5e40ffd11949d123c000691))
+* integrate cosmic-text for improved text measurement and font fallback ([c953f71](https://github.com/twangodev/ogis/commit/c953f71fb0f568cee44bf7e82581dcc137f619d6))
+* integrate HMAC authentication middleware into router for protected routes ([f5664dc](https://github.com/twangodev/ogis/commit/f5664dc959e31565c85b5d354802f67592db3b5b))
+* integrate OpenTelemetry for enhanced observability and metrics collection ([ccd91e1](https://github.com/twangodev/ogis/commit/ccd91e1caa99d16ad17e4cf85a19718447f5a4c9))
+* integrate OpenTelemetry for enhanced observability and metrics collection ([a594b05](https://github.com/twangodev/ogis/commit/a594b05eb25dbb47f1f99589e8b3676060237a2d))
+* integrate shared font database into SVG to PNG rendering ([dcec226](https://github.com/twangodev/ogis/commit/dcec226d6ef6f29ab345941d24c192d5d3579c91))
+* integrate site configuration into Footer and Logo components ([412aa48](https://github.com/twangodev/ogis/commit/412aa483769a0d4095bf17f29d1de1a9949a387c))
+* integrate Swash font caching and measurement for improved text rendering ([1a9fe92](https://github.com/twangodev/ogis/commit/1a9fe92e3cf32ed343a7aff2e71d6101f0413122))
+* integrate tokio-shutdown for graceful server shutdown handling ([ee82827](https://github.com/twangodev/ogis/commit/ee82827b1c80be485012648b34d989cb1e7860c6))
+* **k6:** exercise gradient cache via /templates + setup() + cache_pressure ([#178](https://github.com/twangodev/ogis/issues/178)) ([1ef3921](https://github.com/twangodev/ogis/commit/1ef39212d94467dd0e4b52528b4b8e4bd943d4d6))
+* **k6:** exercise gradient cache via setup() + cache_pressure mode ([59b9926](https://github.com/twangodev/ogis/commit/59b99268dd2ad5330c713f3c13f12af6cfda4ed0))
+* normalize field names to lowercase in error messages for consistency ([3ea0dcb](https://github.com/twangodev/ogis/commit/3ea0dcbb8e43127530babee188c6e2ee7f9d7789))
+* optimize image rendering by adding WebP format and scaling options ([68ba0aa](https://github.com/twangodev/ogis/commit/68ba0aa23884f61f24d89cf276cd13dbed9c9172))
+* optimize metrics recording by removing unnecessary template name cloning ([ea47955](https://github.com/twangodev/ogis/commit/ea47955b0e87b410e594025cba8ba774ca4c5778))
+* optimize text measurement by reusing FontSystem and improving error handling ([520f034](https://github.com/twangodev/ogis/commit/520f034f3599fe21c850f1212ba74075360642a7))
+* refactor attribute retrieval functions for improved error handling and clarity ([bfe4191](https://github.com/twangodev/ogis/commit/bfe41914598583719d6d6f6c6bf30f937efda66e))
+* refactor event writing to use centralized write_event function for improved error handling ([9e9480d](https://github.com/twangodev/ogis/commit/9e9480da649e826a99a4e896495df7b58ea31dca))
+* refactor Navigation component to use Lucide icons and simplify logo rendering ([94ab872](https://github.com/twangodev/ogis/commit/94ab872064f3c7e5f8121157f013139768363526))
+* refactor Open Graph parameters handling and introduce validation and logo fetching logic ([ce80b7e](https://github.com/twangodev/ogis/commit/ce80b7e6fb747c64bc1ebae34a12fe97d58a955a))
+* refactor package name and update base URL for OGIS client ([c28464b](https://github.com/twangodev/ogis/commit/c28464b4e43775e1c579d7757105fba7b56b70f9))
+* refactor replacement handling to use a HashMap for text replacements ([4014b86](https://github.com/twangodev/ogis/commit/4014b8641458778bdbb36f845e2008f7a30572b8))
+* refactor router setup to streamline route definitions and middleware application ([67f065c](https://github.com/twangodev/ogis/commit/67f065ce0d804ffd4d076abfa10fff8fbd0642a1))
+* refactor SVG generation to use quick_xml for improved parsing and error handling ([aef1aaf](https://github.com/twangodev/ogis/commit/aef1aafe361ad6e2d2fda243685a1af929aacc70))
+* refactor URL display by integrating URLBar component and updating layout spacing ([61295a2](https://github.com/twangodev/ogis/commit/61295a2478631823e9d72aeed45a3609eedeeb73))
+* remove early Content-Type check to streamline image fetching process ([174d826](https://github.com/twangodev/ogis/commit/174d826992a4a9f5357feb20c805be5e1b859b5d))
+* remove paths-ignore for web directory in Rust CI workflow ([25846d3](https://github.com/twangodev/ogis/commit/25846d36b143c25578cdc1deca7dbb1ba9191575))
+* remove regex dependency and implement custom hex color validation ([41efe91](https://github.com/twangodev/ogis/commit/41efe913f33888b6aa77d0a94f95313507a56f4e))
+* remove text-transform from subtitle in SVG ([9895543](https://github.com/twangodev/ogis/commit/98955437d95abcf141e653479f3851dc12b92bbc))
+* remove unnecessary letter-spacing from subtitle text in twilight.svg ([0a8959c](https://github.com/twangodev/ogis/commit/0a8959ce2831c304c6fcbda7c3f915c3b163f4f1))
+* remove WebP encoder and integrate new webp crate for image rendering ([b99a0a9](https://github.com/twangodev/ogis/commit/b99a0a9778105b33b9752ddb3902ed383de20c2d))
+* rename apply_color_overrides to override_colors for clarity ([288e691](https://github.com/twangodev/ogis/commit/288e691969592ebe8ff06567f5a3aa90b59f0e3b))
+* rename awaiting_rect_for to replacement_id for clarity in image replacement handling ([c483cab](https://github.com/twangodev/ogis/commit/c483cab6ee4d6c8dbd75de772f044f1c64e58302))
+* rename project from demo to ogis-web in package-lock.json ([9106dba](https://github.com/twangodev/ogis/commit/9106dbaee7560dad51f50d95c8760fe586812428))
+* rename project from demo to ogis-web in package.json ([4cc46f2](https://github.com/twangodev/ogis/commit/4cc46f266f7f1a9ef272528098884a78b118014d))
+* reorder components in Hero.svelte to improve layout flow ([e98583a](https://github.com/twangodev/ogis/commit/e98583af390d04f58c9c3f0daa5357d4df746b9e))
+* replace favicon with Lucide icon and refactor Footer and Navigation components to use Logo component ([0befa8b](https://github.com/twangodev/ogis/commit/0befa8b0d84f8d59ca11b01e134600506bdd1f7b))
+* replace highlighter module to use .js extension ([e52e8bd](https://github.com/twangodev/ogis/commit/e52e8bda7c1dc6625de1138b0becd21be680e54e))
+* restructure configuration for Open Graph image service with nested defaults and image settings ([0f283bf](https://github.com/twangodev/ogis/commit/0f283bfb8358cab231713e2f2ff7633514d70ee6))
+* restructure minimal.svg for improved layout and design flow ([a9bfd83](https://github.com/twangodev/ogis/commit/a9bfd83c8c1db712aad29c35d656014d8ce034a1))
+* restructure minimal.svg for improved layout and design flow [skip ci] ([fabccb2](https://github.com/twangodev/ogis/commit/fabccb23752522c66dad1a32b8c312456b0b729b))
+* **routes:** add GET /templates listing every registered template ([ff52689](https://github.com/twangodev/ogis/commit/ff52689aa61bdc6ba65ea98a8654b52162e8c629))
+* **routes:** route GET / through render_with_gradient_cache ([dff2422](https://github.com/twangodev/ogis/commit/dff24227458f021b4b371fa9e2a70d922a5ef47d))
+* setup mintlify ([65ea711](https://github.com/twangodev/ogis/commit/65ea711985a471fb7fea930758a47cb1b055ec38))
+* simplify default parameter handling by introducing a helper function ([162c6c2](https://github.com/twangodev/ogis/commit/162c6c2dfe42da04f4f17749e692a8b9ffe6bb96))
+* simplify filter logic in params.rs for template color checks ([fc47be0](https://github.com/twangodev/ogis/commit/fc47be0c48f8367fbcc69551a6abc984e7223071))
+* simplify Rust formatting check in GitHub Actions workflow ([ba50fb3](https://github.com/twangodev/ogis/commit/ba50fb32febb3fba53e46834cb34a705031ede89))
+* simplify SVG generation by removing width and height parameters ([f99119e](https://github.com/twangodev/ogis/commit/f99119e5f07c8a1208f3994d3bc8d22dc0f2c325))
+* simplify template availability check and enhance readability ([5547b85](https://github.com/twangodev/ogis/commit/5547b85e58d046a1b36f44093d542dfe3c6bfc43))
+* simplify URL parsing and telemetry guard shutdown logic ([2d76a6a](https://github.com/twangodev/ogis/commit/2d76a6a9c95f220032f30a998c225f816b8a2df2))
+* specify image for ogis service in docker-compose.yml [skip ci] ([35e147e](https://github.com/twangodev/ogis/commit/35e147eba33f54eb8b19228a9f880fe199849e17))
+* standardize references to 'OGIS' as 'ogis' throughout documentation and code ([64756b3](https://github.com/twangodev/ogis/commit/64756b3bcaa2c92b1e6bd28917faed589362e241))
+* **telemetry:** add gradient cache hit and warm-up metrics ([54eb71a](https://github.com/twangodev/ogis/commit/54eb71ad7278673b0542c47d1d67edae62f20cb8))
+* **templates:** pre-split gradient templates into bg + fg halves ([1b1d45e](https://github.com/twangodev/ogis/commit/1b1d45ef01c6feaf7ea91f5edf74b0704e2c49ab))
+* update .env.example to include optional parameters and HMAC secret key ([b066f03](https://github.com/twangodev/ogis/commit/b066f03a4560a32fc5e446e0c05e00926c778217))
+* update ApiError handling for invalid signature format and adjust status codes ([b073baf](https://github.com/twangodev/ogis/commit/b073bafba86240f43ff5839911c992c10a790ee6))
+* update Caddyfile to simplify domain configuration for Let's Encrypt ([2fff7fe](https://github.com/twangodev/ogis/commit/2fff7fe2c94de0c7f0eb2ccc9fa2762688fd9a4d))
+* update Caddyfile to specify domain for Let's Encrypt and remove usage instructions [skip ci] ([de9fc81](https://github.com/twangodev/ogis/commit/de9fc810b1f8b1b49ab3b290c658076fda0a6580))
+* update dashboard metrics for render duration and image fetches ([39181ee](https://github.com/twangodev/ogis/commit/39181eec3c7cfc050c722c5a7c9430039801ae4d))
+* update default thresholds for HTTP request metrics ([bfe3d0f](https://github.com/twangodev/ogis/commit/bfe3d0f7e58b70a507926fbb340a97729e7cd260))
+* update dependencies in Cargo.lock and Cargo.toml for HMAC integration ([b72e1a8](https://github.com/twangodev/ogis/commit/b72e1a856e3cb30e7308054ebe8842e0b1af9299))
+* update displayed bytes metric to terabytes in HeroContent component ([b5ef335](https://github.com/twangodev/ogis/commit/b5ef33555ce74ba65ba67feb9fd3d80f1bb4a238))
+* update Docker configuration to mount fonts and templates directories for runtime configuration ([bd5a050](https://github.com/twangodev/ogis/commit/bd5a050fcae29e703a07d6120e0a3f5328b94e70))
+* update Docker configuration to mount fonts and templates directories for runtime configuration ([3c16c68](https://github.com/twangodev/ogis/commit/3c16c686e111a24344506b1d345deea33f737f26))
+* update Docker Hub description step to use latest action version and include short description ([afaa3f6](https://github.com/twangodev/ogis/commit/afaa3f69d5e068d212c33b325cd9869ec49bff6e))
+* update environment variable for telemetry service name ([cd894d7](https://github.com/twangodev/ogis/commit/cd894d756f6df5e15ad688450e143ca827f92785))
+* update expression for hit percentage metric to handle zero values ([eb47cbc](https://github.com/twangodev/ogis/commit/eb47cbcf8e9591c2932896e96ff352d54b1a2eaf))
+* update font loading to support multiple fallback paths in fonts.yaml ([a3b7a72](https://github.com/twangodev/ogis/commit/a3b7a725b6559e403454c70dc16a8cdd26b6a66e))
+* update footer and navigation links to point to new documentation URLs and enhance external link handling ([55766a0](https://github.com/twangodev/ogis/commit/55766a0defd6e02d9661f70b326545ffb421e2e8))
+* update Footer links and GitHub URL in site configuration ([d735e24](https://github.com/twangodev/ogis/commit/d735e242e87c7225d0157b46b4eee645af4c7252))
+* update GitHub Actions workflow to support multiple branches ([bf49b40](https://github.com/twangodev/ogis/commit/bf49b404e1f250c6a5bb36b4b14260e7218ea3a6))
+* update gradient templates and enhance TemplateMarquee layout for better visual organization ([703c608](https://github.com/twangodev/ogis/commit/703c6085d5ad89dcb1f07555a56ba79c3c7590b5))
+* update HeroContent with new title and description, and adjust layout for better readability ([2efb81c](https://github.com/twangodev/ogis/commit/2efb81c1c611882eef0163e341de72194d98c8a4))
+* update layout and components with new logo handling and favicon adjustments ([d965070](https://github.com/twangodev/ogis/commit/d965070e5f8223b1dcc40a7578deb41a9a031ddf))
+* update logo colors for improved visibility ([efd1bf7](https://github.com/twangodev/ogis/commit/efd1bf7a024f4b94682917e8a9be836b98f27518))
+* update logo paths and modify SVG files for better integration ([6f4f5cc](https://github.com/twangodev/ogis/commit/6f4f5cc804885605db2c9e7ec4f8ea5c4b182c2e))
+* update logo text to 'Placeholder Logo' in gradient SVG files for consistency ([9de459d](https://github.com/twangodev/ogis/commit/9de459d666e9dff3b2c1c881e7c1d5fc34e7be06))
+* update metrics expressions in ogis.json and provider.rs for improved accuracy ([abb16e0](https://github.com/twangodev/ogis/commit/abb16e0beacdb502dc0f3999080a42d88c2039ff))
+* update metrics expressions to utilize histogram data for improved accuracy ([dacf836](https://github.com/twangodev/ogis/commit/dacf836bca66bb64ed9943fab170bca6d18c4da2))
+* update metrics to report requests per minute and adjust field configurations ([91483a8](https://github.com/twangodev/ogis/commit/91483a8017970cd8dee96e34c38d8a038135135c))
+* update Navigation menu with new links for Playground, Templates, Showcase, and Docs ([0785472](https://github.com/twangodev/ogis/commit/078547277ca998d24910d1780af1a5bcae290eda))
+* update Node.js version to 24 in CI configuration and add publish step ([51144b3](https://github.com/twangodev/ogis/commit/51144b3e88c9f38e13d0537f28f66f562c7808f6))
+* update OpenAPI specification with server URL and title change ([a1ab3af](https://github.com/twangodev/ogis/commit/a1ab3af36023b8f1b9f82442a752a3dcf1366985))
+* update package-lock.json for Linux support in Tailwind CSS and Lightning CSS ([d774cab](https://github.com/twangodev/ogis/commit/d774cabadaa5d51f74158ba1c1cbfd66415da8ed))
+* update package-lock.json to rename OGIS package and adjust module links ([1d7878a](https://github.com/twangodev/ogis/commit/1d7878a0ead8491c416005fd2754ae9dda6b8402))
+* update prepublish script to copy README.md and add .gitignore file ([f6516c6](https://github.com/twangodev/ogis/commit/f6516c6442abbaca480f33b9e7137c0a04af7da5))
+* update reddit SVG template with multi-line title and adjusted body text positions ([a4ff353](https://github.com/twangodev/ogis/commit/a4ff3539ddc5de49e3f257bc4aab321994e28ad1))
+* update render duration description for image rendering metrics ([bbd5443](https://github.com/twangodev/ogis/commit/bbd5443b4e18ae79b6774f372b99c53b8361cc24))
+* update template from 'gradient-noir' to 'gradient-storm' for improved visual consistency ([fcc28d6](https://github.com/twangodev/ogis/commit/fcc28d6fbc8acea807d935dcfa54c07489986988))
+* update theme colors and add background settings in documentation configuration ([11413d8](https://github.com/twangodev/ogis/commit/11413d862b5d1820976f91a329a072a019a78d7f))
+* update version to 0.2.0 and add release configuration files ([#121](https://github.com/twangodev/ogis/issues/121)) ([60203bb](https://github.com/twangodev/ogis/commit/60203bb73afa89138213d156fb4b321baa174d5d))
+* web hero ([3906158](https://github.com/twangodev/ogis/commit/3906158ec3d05aa3e16266588474c502fb8449a1))
+
+
+### Bug Fixes
+
+* adjust import order and format YAML reading in font loading ([ec72c4d](https://github.com/twangodev/ogis/commit/ec72c4d6939e3e5c4046c32cf1619622476e586d))
+* collapse nested if in templates.rs to satisfy clippy ([#151](https://github.com/twangodev/ogis/issues/151)) ([096f5d3](https://github.com/twangodev/ogis/commit/096f5d3bb5ad8bfea97cceaf852e10b885ad8978))
+* crop update openai.png ([f4b8ba0](https://github.com/twangodev/ogis/commit/f4b8ba0c3213d11c62fcf6161b56971ce008e2de))
+* enhance logging for OG image generation with detailed parameters ([d6f7774](https://github.com/twangodev/ogis/commit/d6f77742b4c80eb21eedcd00651633cb1ca406ec))
+* improve error handling and formatting in image fetching logic ([8a29deb](https://github.com/twangodev/ogis/commit/8a29deb3186b750f81e495c3ff9511ef3c189955))
+* improve error messages formatting for input validation ([768f880](https://github.com/twangodev/ogis/commit/768f88053cc62fe03c2fa4a3d62590990a1d9fb0))
+* install cargo-chef with --locked in Dockerfile ([#171](https://github.com/twangodev/ogis/issues/171)) ([434a0f3](https://github.com/twangodev/ogis/commit/434a0f3ae9e0c408ea27d6dff20b5ee2e82acd23))
+* introduce emoji fallback ([e78a269](https://github.com/twangodev/ogis/commit/e78a269df2be4a8902b6eb8d5156798270da1b41))
+* **k6:** empty list, URL encoding, and gradient bucketing ([d1ff473](https://github.com/twangodev/ogis/commit/d1ff47310d0f5c451700562848931f6daa9108f6))
+* **k6:** vercel-og benchmark fails after createOptions signature change ([6bb81ee](https://github.com/twangodev/ogis/commit/6bb81ee945777f1560226dfc30f1dca169ab0f23))
+* **k6:** vercel-og.js call site after createOptions() signature change ([00d5a7f](https://github.com/twangodev/ogis/commit/00d5a7fd66a9aa960bee7d02a9a23967a1731388))
+* recrop static images ([708408a](https://github.com/twangodev/ogis/commit/708408adab438711f1bb7efbe81ef1d283e92075))
+* recrop stripe ([c155dac](https://github.com/twangodev/ogis/commit/c155dac6dfb9d998317f5888e37b2d5113c68d34))
+* remove unnecessary branch and path filters from web workflow ([2f3d9fc](https://github.com/twangodev/ogis/commit/2f3d9fc1ba8d1e9d00c99581708c7fac4aeff112))
+* rename build job in workflow for clarity ([4675fb9](https://github.com/twangodev/ogis/commit/4675fb9acb77a8fa685b8108a12be55452a7d8cd))
+* rename build job in workflow for clarity ([b331787](https://github.com/twangodev/ogis/commit/b331787d166a27da133f0ecfc7fae57b0b3ea8c2))
+* rename deployment workflow for clarity ([8cc08c9](https://github.com/twangodev/ogis/commit/8cc08c997d8868155a873c35831ffe51dcb59f9f))
+* replace variable font weights ([#41](https://github.com/twangodev/ogis/issues/41)) ([c99ce11](https://github.com/twangodev/ogis/commit/c99ce11f41a52667e85c09a44e97a724dd037d63))
+* trim warm-up template names before lookup ([8c5be71](https://github.com/twangodev/ogis/commit/8c5be71e3f3ee4b66d5b83b4f3b482525a14e339))
+* update API Reference link to point to the correct external URL ([1b89396](https://github.com/twangodev/ogis/commit/1b89396efac67a2e0aaa64cbbfc8e7533affb38c))
+* update badge links in README for improved accessibility and navigation ([0f524b4](https://github.com/twangodev/ogis/commit/0f524b4ded90b65a252ab832b885345c76cd380d))
+* update font files to use variable fonts ([b07d76d](https://github.com/twangodev/ogis/commit/b07d76dd3f70a8429af3db3e1253b009259d78f4))
+* update main function to return Result for better error handling ([7f4fcab](https://github.com/twangodev/ogis/commit/7f4fcab7862847b8160553232f164005cd2268f1))
+* update README symlink to relative ([b84050a](https://github.com/twangodev/ogis/commit/b84050aa15ceea7c4dbebdbc3dba1742f28a4c86))
+* update Self-Hosting Guide link to ensure correct URL format ([421225c](https://github.com/twangodev/ogis/commit/421225c4b4fc6685e2d5bd270b9144cb0133baa9))
+* update Swagger UI API documentation URL ([16508c7](https://github.com/twangodev/ogis/commit/16508c79567de7ef59b9c5208f9155ab9b662be9))
+* web builds ([1c65377](https://github.com/twangodev/ogis/commit/1c65377885cf30981697e32329c2936b3329effb))
diff --git a/Cargo.lock b/Cargo.lock
index 5317c33..28799b1 100644
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -1505,7 +1505,7 @@ dependencies = [
 
 [[package]]
 name = "ogis"
-version = "0.2.0"
+version = "1.0.0"
 dependencies = [
  "axum",
  "base64",
diff --git a/Cargo.toml b/Cargo.toml
index ef755ce..a2813fa 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "ogis"
-version = "0.2.0"
+version = "1.0.0"
 edition = "2024"
 
 [dependencies]
diff --git a/packages/typescript/package.json b/packages/typescript/package.json
index 0c28d7e..aaeca6c 100644
--- a/packages/typescript/package.json
+++ b/packages/typescript/package.json
@@ -1,6 +1,6 @@
 {
   "name": "ogis",
-  "version": "0.2.0",
+  "version": "1.0.0",
   "type": "module",
   "description": "TypeScript client for OGIS OpenGraph image generation service",
   "main": "dist/index.js",