domma-cms 1.42.3 → 1.44.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # Changelog
2
2
 
3
+ ## [1.44.0] - 2026-11-08
4
+
5
+ - **New self-hosted sites look like domma-cms.com.** What `npx domma-cms <name>` makes:
6
+ - The main menu is the segmented pill bar with card dropdowns and the pop entrance, with a brand pill, plus a **Tools** card linking to Domma's Tools and the Marketplace (and, for admins, the site's own Marketplace). The footer links to both too.
7
+ - Home, About and Contact are rewritten with photos (six CC0 pictures copied into `content/media/starter/`, credits in `scripts/starter-media/CREDITS.md`) and `[text]` gradient highlights.
8
+ - Nunito Sans on the site and in the admin, and the **Atelier Dark** admin.
9
+ - The side admin menu starts **off** (the top menu has everything). New theme.json key `adminSidebar` (default `true`, so existing sites keep it); each person's own choice still wins.
10
+ - Fixed for new sites: the Contact form said "Form not found" (the seed wrote forms to the old form-builder folder, not `content/forms/`), the navbar brand was empty, and three test menus (`sproj-*`) shipped in `config/menus/`. The home page's last section no longer puts a `[hero]` inside `[reveal]`, which printed the hero's settings as text.
11
+
12
+ ## [1.43.0] - 2026-11-08
13
+
14
+ - **Self-hosted sites hear about new versions.** Once a day the site asks npm for the latest Domma CMS; when it is behind, the Super Admins get a notice (Notifications, "Domma CMS update available") saying which version and the command to run. A newer release replaces it and updating ends it. Hosted sites and managers are updated for them, so they never check. server.json `updateCheck: false` or `DOMMA_UPDATE_CHECK=0` turns it off (and ends a notice already shown). See `server/services/cmsUpdates.js`.
15
+ - New sites' `.gitignore` keeps out `content/.crash.json` and `content/.cms-update.json` (runtime state).
16
+
3
17
  ## [1.42.3] - 2026-11-08
4
18
 
5
19
  - Tests: the theme token check reads the Domma stylesheets from the installed domma-js package, as the server serves them, so it passes on a clean checkout (it read a local `public/dist/domma` copy that only old checkouts have).
@@ -1 +1 @@
1
- import{fontFamilyValue as l,fontStylesheetHref as r,isFontStylesheet as f}from"../../../public/js/font-families.mjs?v=20261029-cms-fonts";import{syncThemeAwareLogos as y}from"./theme-aware-logo.js";const a="dm-custom-themes";function h(e={}){const s=(c,d)=>{let m=document.getElementById(c);if(!d){m?.remove();return}m||(m=document.createElement("link"),m.id=c,m.rel="stylesheet",document.head.appendChild(m)),m.href=d},t=f(e.stylesheet)?e.stylesheet:"";s("dm-licensed-fonts",t);const o=r(e.family,{stylesheet:t});s("dm-admin-font-link",o===t?"":o);let n=document.getElementById("dm-admin-font");if(!e.family){n?.remove();return}n||(n=document.createElement("style"),n.id="dm-admin-font",document.head.appendChild(n));const i=l(e.family);n.textContent=`body[class] { --dm-font-sans: ${i}; font-family: var(--dm-font-sans); }`}export function applyAdminTheme(e){const s=e?.dommaTheme||"charcoal-dark";Domma.theme.init({theme:s,persist:!1,target:document.body});let t=document.getElementById(a);e?.css?(t||(t=document.createElement("style"),t.id=a,document.head.appendChild(t)),t.textContent=e.css):t&&t.remove();const o=document.body;for(const n of[...o.classList])n.startsWith("dm-custom-")&&o.classList.remove(n);e?.customClass&&o.classList.add(e.customClass),y(),h(e?.font)}export async function refreshAdminTheme(e,s={}){try{applyAdminTheme(await e.theme.admin(),s)}catch{applyAdminTheme({dommaTheme:"charcoal-dark"},s)}}
1
+ import{fontFamilyValue as l,fontStylesheetHref as r,isFontStylesheet as f}from"../../../public/js/font-families.mjs?v=20261029-cms-fonts";import{syncThemeAwareLogos as y}from"./theme-aware-logo.js";import{setSidebarDefault as h}from"./topbar-account.js";const c="dm-custom-themes";function u(t={}){const n=(a,d)=>{let m=document.getElementById(a);if(!d){m?.remove();return}m||(m=document.createElement("link"),m.id=a,m.rel="stylesheet",document.head.appendChild(m)),m.href=d},e=f(t.stylesheet)?t.stylesheet:"";n("dm-licensed-fonts",e);const o=r(t.family,{stylesheet:e});n("dm-admin-font-link",o===e?"":o);let s=document.getElementById("dm-admin-font");if(!t.family){s?.remove();return}s||(s=document.createElement("style"),s.id="dm-admin-font",document.head.appendChild(s));const i=l(t.family);s.textContent=`body[class] { --dm-font-sans: ${i}; font-family: var(--dm-font-sans); }`}export function applyAdminTheme(t){const n=t?.dommaTheme||"charcoal-dark";Domma.theme.init({theme:n,persist:!1,target:document.body});let e=document.getElementById(c);t?.css?(e||(e=document.createElement("style"),e.id=c,document.head.appendChild(e)),e.textContent=t.css):e&&e.remove();const o=document.body;for(const s of[...o.classList])s.startsWith("dm-custom-")&&o.classList.remove(s);t?.customClass&&o.classList.add(t.customClass),y(),u(t?.font)}export async function refreshAdminTheme(t,n={}){try{const e=await t.theme.admin();applyAdminTheme(e,n),typeof e?.sidebar=="boolean"&&h(e.sidebar)}catch{applyAdminTheme({dommaTheme:"charcoal-dark"},n)}}
@@ -1 +1 @@
1
- let s={};export function renderFrameworkVersions(r){r&&(s=r);for(const[e,i,o]of[["topbar-reactive-version","Reactive",s.reactive],["topbar-js-version","JS",globalThis.Domma?.version||s.js]]){const n=document.getElementById(e);n&&(n.textContent=o||"",n.parentElement.hidden=!o,n.hidden=!o)}}export function sidebarPreferenceKey(r){return"sidebar.visible."+(r?.id||"anonymous")}export function wireAccountMenu(r){c("topbar-account"),c("topbar-versions-menu");const e=document.getElementById("topbar-show-sidebar");if(!e||e.dataset.wired)return;e.dataset.wired="1";const i=sidebarPreferenceKey(r);let o=!0;try{o=S.get(i)!==!1}catch{}const n=a=>{!a&&document.body.classList.contains("dm-sidebar-open")&&document.getElementById("topbar-sidebar-toggle")?.click(),document.body.classList.toggle("dm-sidebar-hidden",!a),e.checked=a};n(o),e.addEventListener("change",()=>{n(e.checked);try{S.set(i,e.checked)}catch{}})}const d=new Map;function c(r){const e=document.getElementById(r);if(!e||e.dataset.wired)return;e.dataset.wired="1";const i=e.querySelector("button"),o=e.querySelector(".topbar-account-menu"),n=t=>{t&&document.dispatchEvent(new CustomEvent("dm:topbar-menu-open",{detail:{owner:e}})),o.hidden=!t,i.setAttribute("aria-expanded",String(t))};i.addEventListener("click",()=>n(o.hidden)),i.addEventListener("keydown",t=>{t.key==="ArrowDown"&&(t.preventDefault(),n(!0),o.querySelector("a, input, button:not(:disabled)")?.focus())}),e.addEventListener("click",t=>{t.target.closest("a")&&n(!1)}),d.get(r)?.abort();const a=new AbortController;d.set(r,a),document.addEventListener("click",t=>{e.contains(t.target)||n(!1)},{signal:a.signal}),document.addEventListener("dm:topbar-menu-open",t=>{t.detail.owner!==e&&n(!1)},{signal:a.signal}),document.addEventListener("keydown",t=>{!t.defaultPrevented&&t.key==="Escape"&&!o.hidden&&(n(!1),i.focus(),t.preventDefault())},{signal:a.signal}),window.addEventListener("hashchange",()=>n(!1),{signal:a.signal})}
1
+ let c={};export function renderFrameworkVersions(o){o&&(c=o);for(const[e,s,a]of[["topbar-reactive-version","Reactive",c.reactive],["topbar-js-version","JS",globalThis.Domma?.version||c.js]]){const t=document.getElementById(e);t&&(t.textContent=a||"",t.parentElement.hidden=!a,t.hidden=!a)}}export function sidebarPreferenceKey(o){return"sidebar.visible."+(o?.id||"anonymous")}const d="sidebar.siteDefault";let i=!0;try{i=S.get(d)!==!1}catch{}let l=null;export function setSidebarDefault(o){i=o!==!1;try{S.set(d,i)}catch{}l?.()}export function wireAccountMenu(o){f("topbar-account"),f("topbar-versions-menu");const e=document.getElementById("topbar-show-sidebar");if(!e||e.dataset.wired)return;e.dataset.wired="1";const s=sidebarPreferenceKey(o),a=()=>{try{const r=S.get(s);return typeof r=="boolean"?r:null}catch{return null}},t=r=>{!r&&document.body.classList.contains("dm-sidebar-open")&&document.getElementById("topbar-sidebar-toggle")?.click(),document.body.classList.toggle("dm-sidebar-hidden",!r),e.checked=r};t(a()??i),l=()=>{a()===null&&t(i)},e.addEventListener("change",()=>{t(e.checked);try{S.set(s,e.checked)}catch{}})}const u=new Map;function f(o){const e=document.getElementById(o);if(!e||e.dataset.wired)return;e.dataset.wired="1";const s=e.querySelector("button"),a=e.querySelector(".topbar-account-menu"),t=n=>{n&&document.dispatchEvent(new CustomEvent("dm:topbar-menu-open",{detail:{owner:e}})),a.hidden=!n,s.setAttribute("aria-expanded",String(n))};s.addEventListener("click",()=>t(a.hidden)),s.addEventListener("keydown",n=>{n.key==="ArrowDown"&&(n.preventDefault(),t(!0),a.querySelector("a, input, button:not(:disabled)")?.focus())}),e.addEventListener("click",n=>{n.target.closest("a")&&t(!1)}),u.get(o)?.abort();const r=new AbortController;u.set(o,r),document.addEventListener("click",n=>{e.contains(n.target)||t(!1)},{signal:r.signal}),document.addEventListener("dm:topbar-menu-open",n=>{n.detail.owner!==e&&t(!1)},{signal:r.signal}),document.addEventListener("keydown",n=>{!n.defaultPrevented&&n.key==="Escape"&&!a.hidden&&(t(!1),s.focus(),n.preventDefault())},{signal:r.signal}),window.addEventListener("hashchange",()=>t(!1),{signal:r.signal})}
package/bin/cli.js CHANGED
@@ -222,11 +222,17 @@ const DEFAULT_SITE_TITLE = 'My Site';
222
222
  const DEFAULT_SITE = {
223
223
  title: DEFAULT_SITE_TITLE,
224
224
  tagline: 'Powered by Domma CMS',
225
+ // The navbar's brand pill (the renderer reads site.json brand; setup renames it with the title).
226
+ brand: {text: DEFAULT_SITE_TITLE, url: '/', icon: 'grid', enabled: true},
225
227
  // The look a new site starts with. First boot lifts these into
226
228
  // config/theme.json (migrateThemeConfig); Appearance > Theme changes them.
227
229
  theme: 'dreamy-light',
228
- adminTheme: 'corporate-light',
229
- fontFamily: 'Open Sans',
230
+ adminTheme: 'admin-atelier-dark',
231
+ fontFamily: 'Nunito Sans',
232
+ adminFontFamily: 'Nunito Sans',
233
+ // The side admin menu starts hidden (the top menu has everything); each
234
+ // person can show it from the Versions panel.
235
+ adminSidebar: false,
230
236
  seo: {
231
237
  defaultTitle: 'My Site',
232
238
  titleSeparator: ' | ',
@@ -11,6 +11,14 @@
11
11
  "text": "Resources",
12
12
  "url": "/resources"
13
13
  },
14
+ {
15
+ "text": "Tools",
16
+ "url": "https://domma-cms.com/tools"
17
+ },
18
+ {
19
+ "text": "Marketplace",
20
+ "url": "https://dcm.dommajs.org/marketplace"
21
+ },
14
22
  {
15
23
  "text": "Contact",
16
24
  "url": "/contact"
@@ -1,13 +1,31 @@
1
1
  {
2
2
  "slug": "main",
3
3
  "name": "Main navigation",
4
- "description": "Migrated from config/navigation.json",
5
- "variant": "light",
4
+ "description": "The site's top menu: your pages, plus Domma's Tools and Marketplace.",
6
5
  "position": "sticky",
6
+ "orientation": "horizontal",
7
+ "appearOnHover": true,
7
8
  "highlight": {
8
- "hover": "darken",
9
9
  "active": "darken"
10
10
  },
11
+ "entrance": {
12
+ "enabled": true,
13
+ "animation": "pop",
14
+ "stagger": 40,
15
+ "duration": 150
16
+ },
17
+ "mobile": {
18
+ "hideBrand": true
19
+ },
20
+ "look": {
21
+ "bar": "segmented",
22
+ "brand": "pill",
23
+ "strip": "none",
24
+ "shrink": true,
25
+ "icons": "rainbow",
26
+ "dropdown": "cards",
27
+ "morph": true
28
+ },
11
29
  "items": [
12
30
  {
13
31
  "text": "Home",
@@ -22,7 +40,114 @@
22
40
  {
23
41
  "text": "Resources",
24
42
  "url": "/resources",
25
- "icon": "book-open"
43
+ "icon": "book-open",
44
+ "panel": {
45
+ "heading": "Learn your way around",
46
+ "link": {
47
+ "text": "All resources",
48
+ "url": "/resources"
49
+ },
50
+ "columns": 2,
51
+ "feature": {
52
+ "tone": "light",
53
+ "eyebrow": "New here?",
54
+ "title": "The Domma CMS user manual",
55
+ "points": [
56
+ "Every screen, step by step",
57
+ "Shortcodes with examples"
58
+ ],
59
+ "button": {
60
+ "text": "Open the manual",
61
+ "url": "https://domma-cms.com/spaces/domma-cms-user-manual"
62
+ }
63
+ }
64
+ },
65
+ "items": [
66
+ {
67
+ "text": "Typography",
68
+ "url": "/resources/typography",
69
+ "icon": "type",
70
+ "description": "Headings, text styles and lists."
71
+ },
72
+ {
73
+ "text": "Grid system",
74
+ "url": "/resources/grid",
75
+ "icon": "layout",
76
+ "description": "Columns and layouts for any page."
77
+ },
78
+ {
79
+ "text": "Cards",
80
+ "url": "/resources/cards",
81
+ "icon": "credit-card",
82
+ "description": "Boxes for features, prices and people."
83
+ },
84
+ {
85
+ "text": "Shortcodes",
86
+ "url": "/resources/shortcodes",
87
+ "icon": "code",
88
+ "description": "Every building block you can drop into a page."
89
+ },
90
+ {
91
+ "text": "Effects",
92
+ "url": "/resources/effects",
93
+ "icon": "zap",
94
+ "description": "Reveals, celebrations and moving text."
95
+ },
96
+ {
97
+ "text": "Interactive",
98
+ "url": "/resources/interactive",
99
+ "icon": "mouse-pointer",
100
+ "description": "Tabs, accordions, carousels and more."
101
+ }
102
+ ]
103
+ },
104
+ {
105
+ "text": "Tools",
106
+ "url": "https://domma-cms.com/tools",
107
+ "icon": "package",
108
+ "panel": {
109
+ "heading": "Add more to your site",
110
+ "link": {
111
+ "text": "See every Tool",
112
+ "url": "https://domma-cms.com/tools"
113
+ },
114
+ "columns": 1,
115
+ "feature": {
116
+ "tone": "accent",
117
+ "eyebrow": "Domma Marketplace",
118
+ "title": "Tools for your own server",
119
+ "points": [
120
+ "Bought once, yours to keep",
121
+ "Updates with one click",
122
+ "Installed from your admin"
123
+ ],
124
+ "button": {
125
+ "text": "Visit the Marketplace",
126
+ "url": "https://dcm.dommajs.org/marketplace"
127
+ }
128
+ }
129
+ },
130
+ "items": [
131
+ {
132
+ "text": "All Tools",
133
+ "url": "https://domma-cms.com/tools",
134
+ "icon": "grid",
135
+ "description": "Shops, bookings, invoices, mail and more."
136
+ },
137
+ {
138
+ "text": "Marketplace",
139
+ "url": "https://dcm.dommajs.org/marketplace",
140
+ "icon": "shopping-bag",
141
+ "description": "Buy Tools for this site, priced for self-hosting."
142
+ },
143
+ {
144
+ "text": "Your Marketplace",
145
+ "url": "/admin/#/plugins",
146
+ "icon": "settings",
147
+ "description": "Install, switch on and update Tools in your admin.",
148
+ "visibility": "admin"
149
+ }
150
+ ]
26
151
  },
27
152
  {
28
153
  "text": "Contact",
@@ -31,9 +156,19 @@
31
156
  }
32
157
  ],
33
158
  "meta": {
34
- "createdAt": "2026-05-24T14:51:22.419Z",
35
- "updatedAt": "2026-05-24T14:51:22.419Z",
159
+ "createdAt": "2026-11-08T00:00:00.000Z",
160
+ "updatedAt": "2026-11-08T00:00:00.000Z",
36
161
  "bundled": false,
37
162
  "presetOwner": null
163
+ },
164
+ "style": {
165
+ "fontFamily": "Nunito Sans",
166
+ "fontSize": "16px",
167
+ "fontWeight": "500",
168
+ "letterSpacing": "0em",
169
+ "iconSize": "16px"
170
+ },
171
+ "dock": {
172
+ "hideOnScroll": true
38
173
  }
39
174
  }
@@ -74,7 +74,7 @@ Code was treated as the truth. Where docs disagree with it, the disagreement is
74
74
  | `shopping-cart-pro` | paid | 0.3.2 | More for the Shop: discount codes (other Tools such as Prize Wheel can make single-use ones), shipping zones with rates by weight or order value, tax by country and class, branded order emails from confirmation to dispatch, and Insights - takings by week, best sellers, repeat customers and abandoned checkouts you can nudge. Adds to the free Shopping Cart; a lapsed licence leaves the Cart and every order just as they were. |
75
75
  | `sliding-puzzle` | paid (giftable) | 1.0.0 | The tile-sliding puzzle, 3x3 to 6x6, numbers or a Media picture. Same board for everyone, a new board each go, or a daily puzzle; every move checked by the server. Fewest moves or fastest time wins. |
76
76
  | `social-media-pro` | paid | 0.4.0 | How the site looks when it is shared, and posting it: share cards per page for Facebook, X, LinkedIn, WhatsApp and Slack with previews; a share image drawn for every page that has none, in the site's colours; share and follow buttons; posting to Bluesky, Mastodon and LinkedIn (through the site's own LinkedIn app, with a reminder before its 60-day sign-in runs out) - now, scheduled, or drafted automatically for every new blog post or page - with links tagged for Analytics and the posts on the Calendar; and LinkedIn conversions - chosen forms reported to LinkedIn's Conversions API when a visitor who accepted marketing cookies sends one. Sold with SEO Pro. |
77
- | `surveys` | paid | 1.5.1 | Targeted surveys over the Forms engine: shared audiences, tokenised invites, reminders, and per-survey statistics. |
77
+ | `surveys` | paid | 1.9.0 | Targeted surveys over the Forms engine: shared audiences, tokenised invites, reminders, and per-survey statistics. |
78
78
  | `sweepstake` | paid (giftable) | 1.0.0 | Office, pub and club sweepstakes for any event: picks, entry fee and prizes, entrants by name with paid ticks, and one recorded, repeatable draw revealed live on the page, then who has what and the money. |
79
79
  | `theme-roller` | paid | 1.1.3 | Make your own themes: start from any built-in theme, change its colours, fonts, spacing and borders with a live preview, and save it. Saved themes join the built-in ones everywhere a theme is chosen - the site, the admin, day and night, a region of a page. Needs Domma CMS 0.73 or later to use them. |
80
80
  | `timeline` | paid (giftable) | 1.0.0 | Put events in date order: all at once (Sort) or one at a time into a growing timeline with lives (Place). Years, months or full dates, BC too; dates stay on the server until a card is placed. Shortcode `[timeline-game]`. |
@@ -2399,7 +2399,7 @@ Control how every page looks when it is shared, and post it. Social Media Pro ed
2399
2399
 
2400
2400
  ### Surveys (`surveys`)
2401
2401
 
2402
- Tier: paid (closed source) · Version: 1.5.0 · Requires: nothing declared; collections declare MongoDB (`storage.adapter: "mongodb"`) and fall back to files when `config/connections.json` is absent · Uses: `contacts` ("Import an audience from Contacts"); notes say core 0.88 · Built over core Forms
2402
+ Tier: paid (closed source) · Version: 1.9.0 · Requires: nothing declared; collections declare MongoDB (`storage.adapter: "mongodb"`) and fall back to files when `config/connections.json` is absent · Uses: `contacts` ("Import an audience from Contacts"); notes say core 0.88 · Built over core Forms
2403
2403
 
2404
2404
  Targeted surveys on top of the Forms engine. Pick any form, choose an audience from your own contact list and groups, send tokenised email invitations and reminders, and watch response rates and per-question statistics - identified or anonymous. Surveys can also be embedded in any page or opened from a hosted survey page with a code.
2405
2405
 
@@ -2409,6 +2409,8 @@ Targeted surveys on top of the Forms engine. Pick any form, choose an audience f
2409
2409
  - Audience (`#/plugins/surveys/audience`): contacts (name, email, groups) with search, add, copy email, delete (contacts cannot be edited once added); named groups (no rename, and no delete-group route); "Import from Contacts" (your own core Contacts; hidden when the Contacts Tool is off).
2410
2410
  - Invitations: one 8-character code per recipient (e.g. `ABCD-EFGH`, SHA-256 hashed, never stored in plain text), sent through the site's SMTP; one response per invite. Links are built on the Site URL setting (`site.baseUrl`), else the old `site.url`, else the request's address (1.4.4).
2411
2411
  - Hosted page `/survey/:slug` (token in `?t=` or typed code), 404 unknown / 403 before its Opens day / 410 closed; submit at `POST /api/plugins/surveys/submit/:slug`.
2412
+ - **Theme per survey (1.9.0)** - Survey page > Theme picks the hosted page's colour theme (any built-in palette or a Theme Roller custom theme); "Use site theme" follows Content > Theme. Before 1.9.0 the hosted page ignored the site theme entirely. Embeds take the host page's theme. Stored as `theme` on the survey (theme id or blank) and carried by JSON export/import.
2413
+ - **Wizard steps scroll to the top (1.9.0)** - Next, Back and logic step jumps on a multi-page survey jump to the top of the hosted page, or to the top of an embedded survey (clear of a sticky navbar), so the next step starts at its first question.
2412
2414
  - Opens/Closes are days in the site's time zone (`timeZone` setting, default `Europe/London`): a survey takes answers from the start of its Opens day to the END of its Closes day. The hosted page, submissions, scheduler reminders, Send (409 once closed), the list chip, the badge and the closing notices all use the same rule (1.4.4).
2413
2415
  - Shortcode `[survey slug="..." /]` - embeds the survey on any page; Copy embed shortcode copies exactly this, and the page gets the survey script added automatically (1.4.4).
2414
2416
  - Results (`#/plugins/surveys/results/:slug`): invited, answered, response rate, per-question aggregates (only this survey's responses, tagged `survey:<slug>`); Export CSV and Export JSON; anonymous flag.
@@ -34,6 +34,7 @@ Controls the HTTP server.
34
34
  | `restartOnPluginToggle` | boolean | `true` | Restart the server automatically when an admin enables or disables a plugin. See **Plugin toggles restart the server** below |
35
35
  | `requireSignedPlugins` | boolean | `false` | When `true`, the site runs only plugin code the Marketplace signed: an unsigned `.dcmsplugin` (e.g. one exported from another site) is refused even if the installer confirms it, New plugin is refused, a plugin's files cannot be changed in the code editor (it opens read only), licensed source cannot be read even by a Super Admin, and MongoDB connection options that start a program or read a file (`autoEncryption`, `tls…File`, …) cannot be saved. A bundle with a signature that does not verify is always refused, whatever this is set to. Read fresh on every check, and also as it was at boot, so changing the file on a running site can switch it on but not off. `DOMMA_SIGNED_ONLY=1` in the environment turns it on whatever the file says - Domma CMS Manager sets it on the sites it hosts. Nothing in the admin writes `server.json`. See `server/services/codePolicy.js` |
36
36
  | `storeUrl` | string \| `false` | Domma's store | Where a **self-hosted** site's Marketplace buys and downloads Tools (Browse). A Tool bought there is the site's to keep, with a term of updates that is renewed with a one-off payment; the licence keys and the payment claims are kept in `config/store.json` (out of git). `false` switches the store off, leaving Install from file. Not used on a site a Domma CMS Manager runs (it buys through its manager), nor on the manager itself unless `storeUrl` is set there. `DOMMA_STORE_URL` in the environment wins. See `server/services/storeClient.js` |
37
+ | `updateCheck` | boolean | `true` | A **self-hosted** site asks npm once a day (and at start-up) for the latest Domma CMS and compares it with its `.domma` marker. When it is behind, the Super Admins get one notice, "Domma CMS x.y.z is available", with the command to run (`npx domma-cms@latest update`); a newer release replaces the notice and updating ends it. Listed in Notifications' settings as "Domma CMS update available". `false` stops the check (so does `DOMMA_UPDATE_CHECK=0`). Never runs on a site a Domma CMS Manager runs, on the manager itself, or in a checkout without `.domma`. See `server/services/cmsUpdates.js` |
37
38
  | `outboundAllowPrivate` | boolean \| string[] | `false` | Webhooks (an Action's webhook step, a form's webhook) reach public addresses only: the name is looked up and every address must be public and not the server's own, the request is pinned to that address, redirects into private addresses are refused, and only ports 80 and 443 are used. A self-hosted site that sends webhooks inside its own network sets `true` to lift those rules for every request, or a list of host names, addresses and CIDR ranges (`["n8n.lan", "192.168.10.0/24", "fd00::/8"]`) to lift them for those only - a name passes if it is listed, or if every address it resolves to is. Ignored on a signed-only site (`requireSignedPlugins` / `DOMMA_SIGNED_ONLY=1`), so a hosted site's admin cannot open the host's network. Read fresh on every request. See `server/services/outbound.js` |
38
39
 
39
40
  ### Plugin toggles restart the server
@@ -423,6 +424,7 @@ Created on first boot by a one-shot migration out of `config/site.json`.
423
424
  |---|---|
424
425
  | `theme` | Public site theme id |
425
426
  | `adminTheme` | Admin panel theme id (admin-chrome themes are only offered here) |
427
+ | `adminSidebar` | Whether the side admin menu shows for someone who has not chosen (default `true`; new self-hosted sites start with `false`). Each person's own "Show side admin menu" choice, under Versions in the top bar, always wins. A new site gets it from `site.json` `adminSidebar` on first boot |
426
428
  | `baseTheme` | Set by the Theme Roller plugin when a generated theme is active. `theme` then names the custom theme and `baseTheme` the built-in one Domma's engine is given; the picker is disabled while it is set. |
427
429
  | `autoTheme` | Day/night pair, switched on each visitor's local time. Ignored when a page pins its own theme, and unavailable with a Theme Roller theme. |
428
430
  | `font.family` / `font.size` | Public site body font and root size |
@@ -32,7 +32,7 @@ You do not need to run `npm install` yourself. Options:
32
32
  | `--no-seed` | Skip seeding default pages, forms and collections |
33
33
  | `--help` | Show usage |
34
34
 
35
- To update an existing project later, run `npx domma-cms update` from inside it (`--dry-run` previews the changes).
35
+ To update an existing project later, run `npx domma-cms@latest update` from inside it (`--dry-run` previews the changes). A self-hosted site checks npm once a day and tells its Super Admins when a newer version is out (Notifications; server.json `updateCheck: false` turns that off).
36
36
 
37
37
  ## What the Scaffolder Creates
38
38
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "domma-cms",
3
- "version": "1.42.3",
3
+ "version": "1.44.0",
4
4
  "description": "File-based CMS powered by Domma and Fastify. Run npx domma-cms my-site to create a new project.",
5
5
  "type": "module",
6
6
  "main": "server/server.js",
package/scripts/seed.js CHANGED
@@ -5,7 +5,8 @@
5
5
  * Safe to run multiple times - overwrites seed paths only.
6
6
  * Run: npm run seed
7
7
  */
8
- import {mkdir, writeFile} from 'node:fs/promises';
8
+ import {copyFile, mkdir, readdir, writeFile} from 'node:fs/promises';
9
+ import {constants as fsConstants} from 'node:fs';
9
10
  import path from 'node:path';
10
11
  import {fileURLToPath} from 'node:url';
11
12
 
@@ -14,8 +15,9 @@ const ROOT = path.resolve(__dirname, '..');
14
15
 
15
16
  const PAGES_DIR = path.join(ROOT, 'content', 'pages');
16
17
  const COLLECTIONS_DIR = path.join(ROOT, 'content', 'collections');
17
- const FORMS_DIR = path.join(ROOT, 'plugins', 'form-builder', 'data', 'forms');
18
- const SUBS_DIR = path.join(ROOT, 'plugins', 'form-builder', 'data', 'submissions');
18
+ // Forms are core: content/forms/<slug>.json (services/forms.js FORMS_DIR). The old
19
+ // form-builder plugin path left every fresh site's Contact form "not found".
20
+ const FORMS_DIR = path.join(ROOT, 'content', 'forms');
19
21
  const NAV_CFG = path.join(ROOT, 'config', 'navigation.json');
20
22
 
21
23
  const now = new Date().toISOString();
@@ -66,109 +68,101 @@ const PAGES = [
66
68
  },
67
69
  body: `[hero fullwidth="true" variant="dark" size="lg" align="left" twinkle twinkle-count="30" blobs]
68
70
 
69
- <span class="hero-label">File-Based CMS</span>
71
+ <span class="hero-label">Your new website</span>
70
72
 
71
- # [scribe speed="60" cursor="true"]The CMS that gets out of your way.[/scribe]
73
+ # [text bold="true"]Your [text gradient="fire" words="true"]website[/text], ready to make your [text gradient="fire" words="true"]own[/text].[/text]
72
74
 
73
- No databases. No bloat. Just Markdown, shortcodes, and a clean admin panel - content management the way it should be.
75
+ [text size="lg" words="true" weight="semibold"][text gradient="fire" words="true"]Pages[/text], [text gradient="fire" words="true"]menus[/text], [text gradient="fire" words="true"]forms[/text] and [text gradient="fire" words="true"]Tools[/text], all in one admin. Change any word on this page from there - nothing here is set in stone.[/text]
74
76
 
75
- <div class="hero-cta"><a href="/admin/">Sign in to Admin →</a> <a href="/resources/">Browse Resources →</a></div>
77
+ [button href="/admin/" size="lg" icon-after="arrow-right"]Sign in to the admin[/button] [button href="https://domma-cms.com/tools" variant="outline" size="lg" icon="package"]Browse Tools[/button]
76
78
 
77
79
  [/hero]
78
80
 
79
- [reveal animation="fade" delay="200"]
81
+ [spacer size="32" /]
80
82
 
81
- [grid cols="4" gap="4"]
83
+ [reveal animation="slide-up"]
84
+ [grid cols="2" gap="6"]
82
85
 
83
86
  [col]
84
- [card]
85
- [counter to="25" suffix="+" /]
86
- **Shortcodes**
87
- Powerful content blocks built right in.
88
- [/card]
87
+ [image src="/media/starter/maker-at-workbench.jpg" alt="A maker working at a wooden workbench" radius="lg" shadow="md" /]
89
88
  [/col]
90
89
 
91
90
  [col]
92
- [card]
93
- [counter to="22" suffix="" /]
94
- **Themes**
95
- Light and dark colour schemes, zero configuration.
96
- [/card]
97
- [/col]
91
+ [text size="sm" transform="upper" spacing="wider" color="primary" bold]Start here[/text]
98
92
 
99
- [col]
100
- [card]
101
- [counter to="3" suffix="" /]
102
- **Plugins**
103
- Extend with effects, analytics, and form handling.
104
- [/card]
105
- [/col]
93
+ ## Three steps to a site that's [text gradient="sunset" words="true"]yours[/text]
106
94
 
107
- [col]
108
- [card]
109
- [counter to="100" suffix="%" /]
110
- **File-based**
111
- Your content lives as plain files - always portable.
112
- [/card]
95
+ [text size="lg" color="muted"]Most people have a site they're happy with in an afternoon.[/text]
96
+
97
+ 1. **Sign in** at [/admin](/admin/) with the account you made during setup.
98
+ 2. **Change the words and pictures** on Home, About and Contact. Every page is edited with a live preview.
99
+ 3. **Pick your look** under Content > Theme: colours, fonts and the menu style.
100
+
101
+ [button href="/admin/" icon="arrow-right"]Open the admin[/button]
113
102
  [/col]
114
103
 
115
104
  [/grid]
116
-
117
105
  [/reveal]
118
106
 
119
- ## Features
107
+ [spacer size="32" /]
108
+
109
+ [center]
110
+ ## Everything is [text gradient="ocean" words="true"]built in[/text]
111
+ [/center]
120
112
 
121
- [reveal animation="slide-up" delay="200"]
113
+ [reveal animation="slide-up" delay="100"]
122
114
  [grid cols="3" gap="4"]
123
115
 
124
116
  [col]
125
- [card title="Markdown Pages" icon="file-text" icon-layout="stacked" hover]
126
- Write content in plain Markdown with YAML frontmatter. Add shortcodes anywhere for rich layouts - no HTML required.
117
+ [card title="Pages that look good" image="/media/starter/colour-swatches.jpg" image-alt="Paint colour swatches fanned out" hover]
118
+ Write in plain words, then drop in building blocks: heroes, cards, galleries, tabs and more. [text bold]Dozens of building blocks and themes[/text] come with every site.
127
119
  [/card]
128
120
  [/col]
129
121
 
130
122
  [col]
131
- [card title="Shortcode System" icon="code" icon-layout="stacked" hover]
132
- From heroes to carousels, counters to accordions - drop expressive shortcodes directly into your Markdown.
123
+ [card title="Forms and enquiries" image="/media/starter/woman-phone-desk.jpg" image-alt="A woman at her desk checking her phone" hover]
124
+ Contact, booking and sign-up forms without code. Every answer lands in your admin, and you can be emailed each time.
133
125
  [/card]
134
126
  [/col]
135
127
 
136
128
  [col]
137
- [card title="Plugin Architecture" icon="code-block" icon-layout="stacked" hover]
138
- Add effects, analytics, and forms through a clean plugin API. Each plugin ships its own routes, config, and admin UI.
129
+ [card title="Tools when you need them" image="/media/starter/packing-parcel-shop-desk.jpg" image-alt="Packing a parcel on a shop desk" hover]
130
+ Add a shop, invoices, bookings, a blog or email from the Marketplace. Buy once, keep it for good, and update with a click.
139
131
  [/card]
140
132
  [/col]
141
133
 
142
134
  [/grid]
143
135
  [/reveal]
144
136
 
145
- [spacer size="24" /]
137
+ [spacer size="32" /]
138
+
139
+ [text size="2xl" align="center" weight="semibold" light-up]Your content lives in plain files on [text gradient="forest" shine="hover"]your own server[/text]. It was yours before you installed Domma CMS, and it stays yours.[/text]
140
+
141
+ [spacer size="32" /]
146
142
 
147
- [reveal animation="slide-up" delay="200"]
148
143
  [hero variant="gradient-purple" size="md" fullwidth="true"]
149
144
 
150
- ## Ready to build?
145
+ ## Ready to add [text gradient="candy" shine="sweep"]more[/text]?
151
146
 
152
147
  [grid cols="2" gap="3"]
153
148
 
154
149
  [col]
155
150
  [ambient color="#a855f7"]
156
- **[Sign in to the admin panel →](/admin/)**
157
- Create pages, manage navigation, and configure your site.
151
+ **[See every Tool →](https://domma-cms.com/tools)**
152
+ Shops, bookings, invoices, mail and more - switch on what you need.
158
153
  [/ambient]
159
154
  [/col]
160
155
 
161
156
  [col]
162
157
  [ambient color="#6366f1"]
163
- **[Browse the resources →](/resources/)**
164
- Guides, shortcode references, and plugin documentation.
158
+ **[Visit the Marketplace →](https://dcm.dommajs.org/marketplace)**
159
+ Tools for self-hosted sites, bought once and yours to keep.
165
160
  [/ambient]
166
161
  [/col]
167
162
 
168
163
  [/grid]
169
164
 
170
165
  [/hero]
171
- [/reveal]
172
166
  `
173
167
  },
174
168
  {
@@ -183,106 +177,81 @@ Guides, shortcode references, and plugin documentation.
183
177
  },
184
178
  body: `[hero variant="dark" size="lg" fullwidth="true" twinkle twinkle-count="30" blobs]
185
179
 
186
- # Build the web your way.
180
+ # [text bold="true"]About [text gradient="fire" words="true"]us[/text][/text]
187
181
 
188
- [scribe speed="35" cursor="true"]No databases. No lock-in. Just files, Markdown, and a CMS that stays out of your way.[/scribe]
182
+ [text size="xl" words="true" weight="semibold"]This is your About page. Tell visitors [text gradient="fire" words="true"]who you are[/text], [text gradient="fire" words="true"]what you do[/text] and why it matters - in your own words.[/text]
189
183
 
190
184
  [/hero]
191
185
 
192
- [spacer /]
193
-
194
- ## What Domma CMS gives you
186
+ [spacer size="32" /]
195
187
 
196
188
  [reveal animation="slide-up"]
189
+ [grid cols="2" gap="6"]
197
190
 
198
- [grid cols="3" gap="4"]
199
191
  [col]
200
- [card title="25 Shortcodes"]
201
- Layout blocks, scroll reveals, counters, heroes, accordions, typewriters - all available directly inside your Markdown. No HTML required.
202
- [/card]
203
- [/col]
204
- [col]
205
- [card title="22 Themes"]
206
- Dark and light variants across 11 carefully crafted palettes. Switch instantly from the admin panel - no rebuild, no redeployment.
207
- [/card]
192
+ [text size="sm" transform="upper" spacing="wider" color="primary" bold]Our story[/text]
193
+
194
+ ## How it [text gradient="sunset" words="true"]started[/text]
195
+
196
+ Every business has a beginning worth telling. Replace this with yours: where you started, what you saw that others missed, and what you set out to do about it.
197
+
198
+ [text italic color="muted"]Tip: people trust a name and a face. A photo of you or your team does more than any paragraph.[/text]
208
199
  [/col]
200
+
209
201
  [col]
210
- [card title="3 Plugins"]
211
- Analytics, smart forms, and visual effects - ready to enable with a toggle. Extend your site without touching a line of code.
212
- [/card]
202
+ [image src="/media/starter/team-planning-meeting.jpg" alt="A team planning around a table" radius="lg" shadow="md" /]
213
203
  [/col]
214
- [/grid]
215
204
 
205
+ [/grid]
216
206
  [/reveal]
217
207
 
218
- [spacer /]
208
+ [spacer size="32" /]
219
209
 
220
- ## By the numbers
210
+ ## What we [text gradient="forest" words="true"]care about[/text]
221
211
 
222
- [reveal animation="zoom"]
212
+ [reveal animation="slide-up" delay="100"]
213
+ [grid cols="3" gap="4"]
223
214
 
224
- [grid cols="4" gap="4"]
225
215
  [col]
226
- <div style="text-align:center;padding:1.5rem 0">
227
-
228
- ## [counter to="25" suffix="+" /]
229
-
230
- Shortcodes
231
-
232
- </div>
216
+ [card title="Doing it properly" icon="check-circle" icon-layout="stacked" hover]
217
+ Say what you stand for. Customers remember a business that does what it says.
218
+ [/card]
233
219
  [/col]
234
- [col]
235
- <div style="text-align:center;padding:1.5rem 0">
236
-
237
- ## [counter to="22" /]
238
-
239
- Themes
240
220
 
241
- </div>
242
- [/col]
243
221
  [col]
244
- <div style="text-align:center;padding:1.5rem 0">
245
-
246
- ## [counter to="3" /]
247
-
248
- Plugins
249
-
250
- </div>
222
+ [card title="Real people" icon="users" icon-layout="stacked" hover]
223
+ Introduce the people behind the name - who answers the phone, who does the work.
224
+ [/card]
251
225
  [/col]
252
- [col]
253
- <div style="text-align:center;padding:1.5rem 0">
254
-
255
- ## [counter to="100" suffix="%" /]
256
-
257
- Markdown
258
226
 
259
- </div>
227
+ [col]
228
+ [card title="Close to home" icon="map-pin" icon-layout="stacked" hover]
229
+ Where you are and who you serve. Local customers look for exactly this.
230
+ [/card]
260
231
  [/col]
261
- [/grid]
262
232
 
233
+ [/grid]
263
234
  [/reveal]
264
235
 
265
- [spacer /]
266
-
267
- [breathe]
268
- ## Our philosophy
269
- [/breathe]
236
+ [spacer size="32" /]
270
237
 
271
- [reveal animation="twinkle"]
238
+ [reveal animation="fade"]
239
+ [grid cols="2" gap="6"]
272
240
 
273
- Content belongs in files - not databases. Domma CMS is built on the conviction that a great publishing tool should be transparent, portable, and free from framework lock-in. Every page is a Markdown file. Every setting is plain JSON. Your content was yours before you installed Domma, and it will still be yours long after.
241
+ [col]
242
+ [image src="/media/starter/colleagues-chatting-coffee.jpg" alt="Two colleagues chatting over coffee" radius="lg" shadow="md" /]
243
+ [/col]
274
244
 
275
- [/reveal]
245
+ [col]
246
+ ## Let's [text gradient="ocean" words="true"]talk[/text]
276
247
 
277
- [spacer size="32" /]
248
+ [text size="lg"]Whether you have a question or you're ready to start, we'd like to hear from you.[/text]
278
249
 
279
- [breathe]
280
- [card title="Explore the shortcode reference"]
281
- Domma ships with 25 shortcodes covering layout, animation, interactivity, and more - all usable straight from the Markdown editor.
250
+ [button href="/contact" icon="mail"]Get in touch[/button]
251
+ [/col]
282
252
 
283
- [Browse the full reference &rarr;](/resources/)
284
- [/card]
285
- [/breathe]
253
+ [/grid]
254
+ [/reveal]
286
255
  `
287
256
  },
288
257
  {
@@ -297,9 +266,9 @@ Domma ships with 25 shortcodes covering layout, animation, interactivity, and mo
297
266
  },
298
267
  body: `[hero variant="dark" size="lg" fullwidth="true" twinkle twinkle-count="50" blobs]
299
268
 
300
- # Get in Touch
269
+ # [text bold="true"]Get in [text gradient="fire" words="true"]touch[/text][/text]
301
270
 
302
- [scribe]We'd love to hear from you - drop us a message and we'll get back to you shortly.[/scribe]
271
+ [text size="xl" words="true" weight="semibold"]We'd love to [text gradient="fire" words="true"]hear from you[/text]. Send us a message and we'll get back to you shortly.[/text]
303
272
 
304
273
  [/hero]
305
274
 
@@ -310,13 +279,15 @@ Domma ships with 25 shortcodes covering layout, animation, interactivity, and mo
310
279
  [col]
311
280
 
312
281
  [reveal animation="fade-up"]
313
- [card title="Contact Information"]
282
+ [card title="Contact information" image="/media/starter/woman-phone-desk.jpg" image-alt="A woman at her desk checking her phone"]
314
283
 
315
284
  <p><span data-icon="mail"></span> &nbsp;<strong>Email</strong><br>hello@example.com</p>
316
285
 
317
286
  <p><span data-icon="phone"></span> &nbsp;<strong>Phone</strong><br>+44 20 0000 0000</p>
318
287
 
319
- <p><span data-icon="clock"></span> &nbsp;<strong>Office Hours</strong><br>Monday - Friday, 9am - 5pm</p>
288
+ <p><span data-icon="clock"></span> &nbsp;<strong>Opening hours</strong><br>Monday - Friday, 9am - 5pm</p>
289
+
290
+ [text size="sm" color="muted"]Change these details in the page editor - they're only examples.[/text]
320
291
 
321
292
  [/card]
322
293
  [/reveal]
@@ -329,7 +300,7 @@ Domma ships with 25 shortcodes covering layout, animation, interactivity, and mo
329
300
 
330
301
  [reveal animation="fade-up"]
331
302
 
332
- [card title="Send Us a Message"]
303
+ [card title="Send us a message"]
333
304
 
334
305
  <div data-form="enquiries"></div>
335
306
 
@@ -1958,6 +1929,25 @@ for (const page of PAGES) {
1958
1929
  console.log(` ✓ ${urlLabel || '/'}`);
1959
1930
  }
1960
1931
 
1932
+ // Starter photos (CC0, see scripts/starter-media/CREDITS.md) for the pages above.
1933
+ // Never over a file already there: a site re-seeding keeps its own pictures.
1934
+ {
1935
+ const from = path.join(__dirname, 'starter-media');
1936
+ const to = path.join(ROOT, 'content', 'media', 'starter');
1937
+ let copied = 0;
1938
+ try {
1939
+ await mkdir(to, {recursive: true});
1940
+ for (const name of await readdir(from)) {
1941
+ if (!/\.(jpe?g|png|webp)$/i.test(name)) continue;
1942
+ try { await copyFile(path.join(from, name), path.join(to, name), fsConstants.COPYFILE_EXCL); copied++; }
1943
+ catch { /* already there */ }
1944
+ }
1945
+ console.log(` ✓ starter photos (${copied} new)`);
1946
+ } catch (err) {
1947
+ console.log(` ⚠ starter photos not copied: ${err.message}`);
1948
+ }
1949
+ }
1950
+
1961
1951
  process.stdout.write(' Updating navigation…');
1962
1952
  await writeFile(NAV_CFG, JSON.stringify(SEED_NAV, null, 4) + '\n', 'utf8');
1963
1953
  console.log(' done.');
@@ -1976,15 +1966,8 @@ for (const col of COLLECTIONS) {
1976
1966
  }
1977
1967
 
1978
1968
  await mkdir(FORMS_DIR, {recursive: true});
1979
- await mkdir(SUBS_DIR, {recursive: true});
1980
1969
  for (const form of FORMS) {
1981
1970
  await writeFile(path.join(FORMS_DIR, `${form.slug}.json`), JSON.stringify(form.data, null, 4) + '\n', 'utf8');
1982
- // Only initialise submissions file if it doesn't already exist
1983
- const subsFile = path.join(SUBS_DIR, `${form.slug}.json`);
1984
- try {
1985
- await writeFile(subsFile, '[]\n', {encoding: 'utf8', flag: 'wx'});
1986
- } catch { /* already exists */
1987
- }
1988
1971
  const colSlug = form.data.actions?.collection?.slug ?? '-';
1989
1972
  console.log(` ✓ form: ${form.slug} → collection: ${colSlug}`);
1990
1973
  }
package/scripts/setup.js CHANGED
@@ -256,6 +256,10 @@ section('4. Site Identity');
256
256
  if (siteTitle && site.smtp && (!site.smtp.fromName || site.smtp.fromName === previousTitle)) {
257
257
  site.smtp.fromName = siteTitle;
258
258
  }
259
+ // The navbar brand shows the site's name: rename it too, unless someone changed it.
260
+ if (siteTitle && site.brand && (!site.brand.text || site.brand.text === previousTitle)) {
261
+ site.brand.text = siteTitle;
262
+ }
259
263
  await writeFile(SITE_CONFIG, JSON.stringify(site, null, 4) + '\n', 'utf8');
260
264
 
261
265
  const nav = JSON.parse(await readFile(NAV_CONFIG, 'utf8'));
@@ -0,0 +1,12 @@
1
+ # Starter photos
2
+
3
+ Copied into a new site's content/media/starter/ by scripts/seed.js. All are CC0 (public domain).
4
+
5
+ | File | Photographer | Source | Licence |
6
+ |---|---|---|---|
7
+ | maker-at-workbench.jpg | m0851 m0851 | https://commons.wikimedia.org/wiki/File:Craft_project_(Unsplash).jpg | CC0 (Wikimedia Commons) |
8
+ | colour-swatches.jpg | Markus Spiske | https://stocksnap.io/photo/colors-colours-P3GRWHODKN | CC0 (StockSnap) |
9
+ | woman-phone-desk.jpg | Kristin Hardwick | https://stocksnap.io/photo/browsing-smartphone-JXOLOKSWX2 | CC0 (StockSnap) |
10
+ | packing-parcel-shop-desk.jpg | Bench Accounting | https://stocksnap.io/photo/box-boxes-WP1KHDXGOY | CC0 (StockSnap) |
11
+ | team-planning-meeting.jpg | Direct Media | https://stocksnap.io/photo/business-team-W6PNBNYHM6 | CC0 (StockSnap) |
12
+ | colleagues-chatting-coffee.jpg | Direct Media | https://stocksnap.io/photo/business-women-BOWOZQBREK | CC0 (StockSnap) |
@@ -123,7 +123,8 @@ export async function themeRoutes(fastify, opts = {}) {
123
123
  const id = asked || saved;
124
124
  const {dommaTheme, customClass} = resolveThemeClasses(id, cfg);
125
125
  return {theme: id, dommaTheme, customClass, css: customClass ? compileCustomThemeCss([id]) : '',
126
- font: {family: cfg.font?.adminFamily || '', stylesheet: cfg.font?.stylesheet || ''}};
126
+ font: {family: cfg.font?.adminFamily || '', stylesheet: cfg.font?.stylesheet || ''},
127
+ sidebar: cfg.adminSidebar !== false};
127
128
  });
128
129
 
129
130
  /*
@@ -0,0 +1,163 @@
1
+ /**
2
+ * "A newer Domma CMS is out" - the notice a SELF-HOSTED site gets.
3
+ *
4
+ * A hosted site is updated by its manager and an owner instance (the manager
5
+ * itself) by the fleet roll, so neither is told. A self-hosted site has nobody
6
+ * doing it for it, and until this nothing in the admin said an update existed.
7
+ *
8
+ * Once a day (and at start-up) the site asks the npm registry for the latest
9
+ * domma-cms and compares it with its own `.domma` marker. Behind = one notice
10
+ * to the Super Admins, `core:cms-update`, saying which version and the command
11
+ * to run. A newer release replaces the notice (unread again); updating ends it.
12
+ *
13
+ * Only a scaffolded project checks: one with a `.domma` marker. The engine's
14
+ * own checkout (and every test copy of it) has none, so it never calls out.
15
+ *
16
+ * Off switches: server.json `updateCheck: false`, or `DOMMA_UPDATE_CHECK=0`.
17
+ * `DOMMA_UPDATE_URL` points the check at another registry document (tests).
18
+ *
19
+ * @module services/cmsUpdates
20
+ */
21
+ import fs from 'fs';
22
+ import path from 'path';
23
+ import {config, getConfig} from '../config.js';
24
+ import {compareVersions} from './pluginInstaller.js';
25
+
26
+ export const REGISTRY_URL = 'https://registry.npmjs.org/domma-cms/latest';
27
+ export const PACKAGE_PAGE = 'https://www.npmjs.com/package/domma-cms';
28
+ const VERSION = /^\d+\.\d+\.\d+$/;
29
+ const TIMEOUT = 10_000;
30
+
31
+ // ---------------------------------------------------------------------------
32
+ // Pure decisions
33
+ // ---------------------------------------------------------------------------
34
+
35
+ /**
36
+ * Should this site look for updates at all.
37
+ *
38
+ * @param {object} site
39
+ * @param {boolean} site.scaffolded - it has a `.domma` marker
40
+ * @param {boolean} site.managed - a manager runs it (it updates the site)
41
+ * @param {boolean} site.owner - an owner instance (the fleet roll updates it)
42
+ * @param {*} site.setting - server.json `updateCheck`
43
+ * @param {string|undefined} site.env - DOMMA_UPDATE_CHECK
44
+ */
45
+ export function updateCheckOn({scaffolded, managed, owner, setting, env}) {
46
+ if (!scaffolded || managed || owner) return false;
47
+ if (env === '0' || env === 'false') return false;
48
+ return setting !== false;
49
+ }
50
+
51
+ /**
52
+ * The notice for an installed version against the latest, or null when there
53
+ * is nothing to say (up to date, ahead, or either version unreadable).
54
+ *
55
+ * @param {string|null} installed
56
+ * @param {string|null} latest
57
+ * @returns {{severity: string, title: string, body: string, link: string}|null}
58
+ */
59
+ export function cmsUpdateNotice(installed, latest) {
60
+ if (!VERSION.test(String(installed ?? '')) || !VERSION.test(String(latest ?? ''))) return null;
61
+ if (compareVersions(latest, installed) <= 0) return null;
62
+ return {
63
+ severity: 'info',
64
+ title: `Domma CMS ${latest} is available`,
65
+ body: `This site runs Domma CMS ${installed}. To update, run this in the site's folder:\n\n`
66
+ + `npx domma-cms@latest update\n\n`
67
+ + `Add --dry-run to see what would change first. The update keeps your content, settings and your own `
68
+ + `plugins, updates the plugins that come with Domma CMS, and backs up the files it replaces before it `
69
+ + `starts. What changed is in CHANGELOG.md.`,
70
+ link: PACKAGE_PAGE
71
+ };
72
+ }
73
+
74
+ /** The version in the registry's `latest` document, or null when it is not a plain x.y.z. */
75
+ export function latestFromRegistry(doc) {
76
+ const v = doc && typeof doc === 'object' ? doc.version : null;
77
+ return typeof v === 'string' && VERSION.test(v) ? v : null;
78
+ }
79
+
80
+ // ---------------------------------------------------------------------------
81
+ // I/O
82
+ // ---------------------------------------------------------------------------
83
+
84
+ /** The version this project was last updated to, from its `.domma` marker. */
85
+ export function markerVersion(root = process.cwd()) {
86
+ try {
87
+ const v = JSON.parse(fs.readFileSync(path.join(root, '.domma'), 'utf8'))?.cmsVersion;
88
+ return typeof v === 'string' ? v : null;
89
+ } catch {
90
+ return null;
91
+ }
92
+ }
93
+
94
+ /** The latest domma-cms on npm. Throws when the registry cannot be read. */
95
+ export async function fetchLatestVersion({fetchImpl = fetch, url = process.env.DOMMA_UPDATE_URL || REGISTRY_URL} = {}) {
96
+ const res = await fetchImpl(url, {headers: {Accept: 'application/json'}, signal: AbortSignal.timeout(TIMEOUT)});
97
+ if (!res.ok) throw new Error(`the registry answered ${res.status}`);
98
+ const latest = latestFromRegistry(await res.json());
99
+ if (!latest) throw new Error('the registry did not give a version');
100
+ return latest;
101
+ }
102
+
103
+ /** Which version the live notice is about, kept beside .crash.json so a newer one can end it. */
104
+ function stateFile() {
105
+ return path.join(path.dirname(path.resolve(config.content.collectionsDir)), '.cms-update.json');
106
+ }
107
+
108
+ /** Is a notice still live from an earlier check (its version is on record). */
109
+ export function noticeOnRecord(file = stateFile()) {
110
+ return readNotified(file) !== null;
111
+ }
112
+
113
+ function readNotified(file) {
114
+ try { return JSON.parse(fs.readFileSync(file, 'utf8'))?.version || null; } catch { return null; }
115
+ }
116
+
117
+ function writeNotified(file, version) {
118
+ try {
119
+ if (version) fs.writeFileSync(file, JSON.stringify({version}) + '\n');
120
+ else fs.rmSync(file, {force: true});
121
+ } catch { /* the dedupe key still stops a repeat */ }
122
+ }
123
+
124
+ /** Is the check on for this running site. */
125
+ export async function updateCheckEnabled() {
126
+ const {isManaged} = await import('./managerClient.js');
127
+ const {isOwnerInstance} = await import('./storeClient.js');
128
+ let setting;
129
+ try { setting = getConfig('server')?.updateCheck; } catch { setting = undefined; }
130
+ return updateCheckOn({
131
+ scaffolded: markerVersion() !== null, managed: isManaged(), owner: isOwnerInstance(),
132
+ setting, env: process.env.DOMMA_UPDATE_CHECK
133
+ });
134
+ }
135
+
136
+ /**
137
+ * The scheduled check: raise, replace or end the notice. `raise`/`resolve` are
138
+ * the notifier's (notify.js runSource hands them in). The options are for the
139
+ * tests; a running site passes none.
140
+ */
141
+ export async function checkForCmsUpdate({notify: raise, resolve}, {fetchImpl, enabled, installed, file = stateFile()} = {}) {
142
+ if (!(enabled ?? await updateCheckEnabled())) {
143
+ // Switched off, or a manager took the site over: end a notice an earlier check raised.
144
+ const stale = readNotified(file);
145
+ if (stale) {
146
+ await resolve(`cms-update:${stale}`);
147
+ writeNotified(file, null);
148
+ }
149
+ return;
150
+ }
151
+ const current = installed ?? markerVersion();
152
+ const latest = await fetchLatestVersion(fetchImpl ? {fetchImpl} : {});
153
+ const notice = cmsUpdateNotice(current, latest);
154
+ const notified = readNotified(file);
155
+ // A newer release replaces the notice, and updating ends it.
156
+ if (notified && (!notice || notified !== latest)) await resolve(`cms-update:${notified}`);
157
+ if (notice) {
158
+ await raise({...notice, dedupeKey: `cms-update:${latest}`});
159
+ writeNotified(file, latest);
160
+ } else if (notified) {
161
+ writeNotified(file, null);
162
+ }
163
+ }
@@ -260,6 +260,17 @@ export async function registerCoreSources() {
260
260
  }
261
261
  });
262
262
 
263
+ // Self-hosted sites only: hosted ones are updated by their manager, and the
264
+ // manager itself by the fleet roll (services/cmsUpdates.js). Also registered
265
+ // while a notice from before is on record, so a site switched off (or taken
266
+ // over by a manager) has that notice ended by the check.
267
+ const cmsUpdates = await import('./cmsUpdates.js');
268
+ if (await cmsUpdates.updateCheckEnabled() || cmsUpdates.noticeOnRecord()) registerNotificationSource({
269
+ id: 'core:cms-update', label: 'Domma CMS update available', severity: 'info', every: 'daily', atBoot: true,
270
+ description: 'A newer Domma CMS is on npm. Checked once a day; server.json "updateCheck": false stops the check.',
271
+ check: (ctx) => cmsUpdates.checkForCmsUpdate(ctx)
272
+ });
273
+
263
274
  registerNotificationSource({
264
275
  id: 'core:disk', label: 'Disk space low', severity: 'warning', every: 'hourly', atBoot: true,
265
276
  description: 'Under 10% (or 1 GB) free on the disk that holds the site\'s content.',
@@ -324,6 +324,9 @@ export function buildGitignore({sitePlugins = [], pluginContent = {}, sitePublic
324
324
  // When each notification source last ran, and which one-off migrations have run - rewritten by the CMS itself.
325
325
  '/content/.notification-sources.json',
326
326
  '/content/.migrations.json',
327
+ // A crash on the way down (read at the next start), and which CMS release the update notice is about.
328
+ '/content/.crash.json',
329
+ '/content/.cms-update.json',
327
330
  '/content/instances_log.json',
328
331
  '/content/preview-links.json',
329
332
  // Each admin's own Dashboard Pro layout (keyed by user id); the site default beside it is tracked.
@@ -88,6 +88,10 @@ export function defaultThemeConfig() {
88
88
  nightStart: '19:00'
89
89
  },
90
90
  font: {family: 'Roboto', size: 16},
91
+ // Whether the side admin menu shows for someone who has not chosen (the
92
+ // Versions panel's "Show side admin menu" is each person's own choice, kept
93
+ // in their browser). New self-hosted sites start with it off.
94
+ adminSidebar: true,
91
95
  // The public theme switcher - a floating disc of theme dots. Off by
92
96
  // default: a visitor-facing theme picker is a choice a site makes, not
93
97
  // something it should acquire by upgrading.
@@ -414,7 +418,8 @@ export function themeConfigFromSite(site = {}) {
414
418
  adminTheme: site.adminTheme,
415
419
  baseTheme: site.baseTheme || null,
416
420
  autoTheme: site.autoTheme,
417
- font: {family: site.fontFamily, size: site.fontSize},
421
+ font: {family: site.fontFamily, size: site.fontSize, adminFamily: site.adminFontFamily},
422
+ adminSidebar: site.adminSidebar,
418
423
  overrides: []
419
424
  });
420
425
  }
@@ -684,6 +689,9 @@ export function validateThemeConfig(input, {remembered = []} = {}) {
684
689
  }
685
690
  }
686
691
  }
692
+ if (input.adminSidebar !== undefined && typeof input.adminSidebar !== 'boolean') {
693
+ errors.push('adminSidebar must be true or false');
694
+ }
687
695
  if (input.font) {
688
696
  if (input.font.stylesheet && !isFontStylesheet(input.font.stylesheet)) {
689
697
  errors.push('Font stylesheet must be a CSS file under /public/fonts/, for example /public/fonts/brand.css');
@@ -1,17 +0,0 @@
1
- {
2
- "slug": "sproj-1779696558011-menu",
3
- "name": "Test menu",
4
- "description": "",
5
- "items": [
6
- {
7
- "text": "X",
8
- "url": "/x"
9
- }
10
- ],
11
- "meta": {
12
- "createdAt": "2026-05-25T08:09:18.015Z",
13
- "updatedAt": "2026-05-25T08:09:18.015Z",
14
- "bundled": true,
15
- "presetOwner": "test-scaff-project"
16
- }
17
- }
@@ -1,18 +0,0 @@
1
- {
2
- "slug": "sproj-1779696960337-menu",
3
- "name": "Test menu",
4
- "description": "",
5
- "items": [
6
- {
7
- "text": "X",
8
- "url": "/x"
9
- }
10
- ],
11
- "meta": {
12
- "createdAt": "2026-05-25T08:16:00.349Z",
13
- "updatedAt": "2026-05-25T08:16:00.349Z",
14
- "bundled": true,
15
- "presetOwner": "test-scaff-project",
16
- "project": "sproj-1779696960337"
17
- }
18
- }
@@ -1,18 +0,0 @@
1
- {
2
- "slug": "sproj-1779696985353-menu",
3
- "name": "Test menu",
4
- "description": "",
5
- "items": [
6
- {
7
- "text": "X",
8
- "url": "/x"
9
- }
10
- ],
11
- "meta": {
12
- "createdAt": "2026-05-25T08:16:25.364Z",
13
- "updatedAt": "2026-05-25T08:16:25.364Z",
14
- "bundled": true,
15
- "presetOwner": "test-scaff-project",
16
- "project": "sproj-1779696985353"
17
- }
18
- }