paullaros · Oct 31, 2026 · Oct 31, 2026 · Oct 31, 2026
diff --git a/AGENTS.md b/AGENTS.md
@@ -31,5 +31,5 @@ Free Bootstrap 5 admin template, published to npm as `@adminkit/core`.
 
 ## Conventions
 
-- Conventional Commits, see `CONTRIBUTING.md`; lefthook enforces them.
+- Conventional Commits, see `CONTRIBUTING.md`; lefthook enforces them. Releases follow "Releasing" there.
 - A PR that changes behaviour adds a short, user-facing line under `Unreleased` in `CHANGELOG.md`, like "Add pricing page (/pages-pricing.html)" or "Upgrade dependencies".
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [4.1.0] - 2026-10-31
+
 - Drop the `ak-` prefix from classes, Sass variables and functions (`.ak-reveal` → `.reveal`); the old names work until v5
 - Upgrade dependencies
 

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -47,3 +47,15 @@ Page, plugin and icon counts are generated, never typed: `npm run stats` updates
 ## Changelog
 
 A PR that changes behaviour adds a line under `Unreleased` in `CHANGELOG.md`. The file follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). Pure refactors, formatting and tooling changes that users never notice don't need an entry. Keep each line short, imperative and user-facing, like the released entries ("Add pricing page (/pages-pricing.html)", "Upgrade to Bootstrap v5.3.8"); one line per change a template user would notice, no internal tooling and no explanations. Notable dependency majors get "Upgrade to X vN", the rest "Upgrade dependencies".
+
+## Releasing
+
+Release AdminKit PRO first, so its counts are final, then this repository. A fix is a patch release; new features or names that keep the old ones working are a minor; anything that breaks a page or a name is a major.
+
+1. Branch `chore/release-<version>` from `main`.
+2. Run `npm version <version> --no-git-tag-version`, then `npm run stats:sync -- --pro ../adminkit-pro` (it runs `npm run stats` too).
+3. In `CHANGELOG.md`, add `## [<version>] - <YYYY-MM-DD>` right under `## [Unreleased]`, so the unreleased lines move into it.
+4. Commit as `chore(release): <version>`, open a PR titled `release: AdminKit <version>` and squash-merge it.
+5. Tag the merge commit and push the tag: `git tag -a v<version> -m "AdminKit <version>" && git push origin v<version>`. The Release workflow builds `dist/` and attaches `adminkit-v<version>.zip` to a GitHub release; name it `AdminKit <version>` and paste the version's changelog lines as its notes.
+6. Publish to npm from the tagged commit: `npm publish` (`prepublishOnly` builds first).
+7. In the website repository, refresh the docs previews: `npm run preview:sync -- --free ../adminkit --pro ../adminkit-pro`.
diff --git a/README.md b/README.md
@@ -49,7 +49,7 @@ Need more? [AdminKit PRO](https://adminkit.io/pricing/) adds more pages, dashboa
 | Pages                 | 20            | 53                                           |
 | Dashboards            | 1             | 5                                            |
 | Plugins               | 4             | 11                                           |
-| Icons                 | 2,015         | 4,071                                        |
+| Icons                 | 2,015         | 4,178                                        |
    | Sidebar color schemes | 1             | 3                                            |
 | Dark mode             | ✔             | ✔                                            |
 | AI features           |               | ✔                                            |

diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@adminkit/core",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "AdminKit - Bootstrap 5 Admin Template",
   "engines": {
     "node": ">=24"

diff --git a/src/data/editions/pro.json b/src/data/editions/pro.json
@@ -1,6 +1,6 @@
 {
   "edition": "pro",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "pages": {
     "count": 53,
     "list": [
@@ -153,8 +153,8 @@
     ]
   },
   "icons": {
-    "total": 4071,
-    "lucide": 1908,
+    "total": 4178,
+    "lucide": 2015,
     "fontAwesome": {
       "solid": 1422,
       "regular": 169,
@@ -176,7 +176,7 @@
     { "id": "pages", "label": "Pages", "pro": 53 },
     { "id": "dashboards", "label": "Dashboards", "pro": 5 },
     { "id": "plugins", "label": "Plugins", "pro": 11 },
-    { "id": "icons", "label": "Icons", "pro": 4071 },
+    { "id": "icons", "label": "Icons", "pro": 4178 },
     { "id": "colorSchemes", "label": "Sidebar color schemes", "pro": 3 },
     { "id": "darkMode", "label": "Dark mode", "pro": true },
     { "id": "aiChat", "label": "AI features", "pro": true },

diff --git a/src/data/stats.json b/src/data/stats.json
@@ -1,6 +1,6 @@
 {
   "edition": "free",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "pages": {
     "count": 20,
     "list": [
@@ -66,7 +66,7 @@
     { "id": "pages", "label": "Pages", "free": 20, "pro": 53 },
     { "id": "dashboards", "label": "Dashboards", "free": 1, "pro": 5 },
     { "id": "plugins", "label": "Plugins", "free": 4, "pro": 11 },
-    { "id": "icons", "label": "Icons", "free": 2015, "pro": 4071 },
+    { "id": "icons", "label": "Icons", "free": 2015, "pro": 4178 },
     {
       "id": "colorSchemes",
       "label": "Sidebar color schemes",