react-website/docs/CMS-GUIDE.md

BlackDice Studio — editor's guide

Studio is the one place the website is changed. It lives at https://www.blackdice.ai/admin (locally: http://localhost:5173/admin).

Nothing you do is visible to the public until you press Publish changes.

---

The screen

• Left: the Studio panel — tabs, lists and settings.
• Right: the real website, showing your unpublished draft. What you see is what visitors will get once you publish.
• Bottom left: the Publish button, and a status line telling you whether you have unsaved changes.

Your work is saved in your browser as you type, so closing the tab by accident does not lose it. Reopen Studio and it comes back.

---

Changing words and pictures — the Pages tab

1. Pick a page from the list (Home, Mobile SDK, News, Contact…).
2. Make sure the toggle says Edit page.
3. Click any text on the page and type. Enter makes a line break within the same heading or paragraph.
4. Click any image to replace it. Pick a file — it is resized automatically, so photos straight from a camera are fine.
5. Press Publish changes.

Useful details:

• The search box lists every piece of copy on the page. Click a line to jump straight to it on the page.
• A line with an orange edge has been changed. Its undo button restores the original wording.
• Headline numbers (the figures that count up as you scroll) are edited in the panel, as a number plus a suffix — e.g. 76 and %.
• Preview turns editing off so you can click through the page like a visitor.

---

Publishing an article — the Articles tab

Articles cover four categories: Insights, News, Press and Events. They appear in the newsroom at /news, in the "Latest news and insights" strip on the home page, and each gets its own page at blackdice.ai/blog/<url> that you can share.

To add one:

1. + New article.
2. Fill in the title, then press from title next to the URL so the web address matches the headline.
3. Choose the category and date.
4. Author — a credit in brackets is shown under the image, not next to the date. For example Paul Hague (Image by Jorge Fernández Salas on Unsplash).
5. Excerpt — the summary shown on cards and in Google results. Keep it under about 300 characters, or press "Use the opening of the article".
6. Hero image — upload one; it is resized for you.
7. Body — write in the editor, or paste straight from Word or Outlook. Pasted formatting is cleaned automatically so the article picks up the site's own fonts and colours. Use the toolbar for headings, lists, links and pull quotes.
8. Leave the article as Draft while it is being reviewed. Draft articles are not listed anywhere and are kept out of Google, but you can still send the /blog/<url> link to a colleague for approval.
9. Switch it to Published, then press Publish changes.

Awaiting approval: the GSMA Open Gateway press release is already in the library as a draft. It needs the approved quotes, the release and availability dates, a hero image, and the review note at the bottom removed — then switch it to Published.

To remove an article: open it and press Delete, then publish. Its URL will show a "that article has moved" page rather than an error.

---

Demo clips — the Demos tab

Two pages carry demos:

• Mobile SDK — scam call (voice/VOIP), scam SMS, SIM swap, per-device DNS analytics, permissions checking. Until a clip is uploaded, each tab plays the interactive demo built into the site, so the page is never empty.
• Halo CPE — the Retina dashboard and Angel web UI walkthroughs. These appear under the existing screenshots once a clip is uploaded.

For each slot you can set the title and caption, upload the clip (MP4 or WebM, up to 32MB — for anything larger, host it and paste the URL), upload a poster still, and hide the slot entirely.

---

Titles, Google and where enquiries go — the SEO tab

Per page: the browser/search title (aim for under 60 characters), the meta description (under 160), and an optional share image for LinkedIn and X.

Site-wide:

• Enquiry forms send to — every form on the site, currently campbell.ferrier@blackdice.ai.
• Copy enquiries to — an optional second address.
• Public contact address and the canonical site URL.

sitemap.xml is rebuilt automatically from whatever is published, so new articles become crawlable as soon as you publish them.

---

Enquiries tab

Every form submission is recorded here — name, email, company, phone, the page they were on and their message — as well as being emailed. Export the list as CSV for HubSpot.

---

History tab

• Snapshots — a copy of the site content is taken every time you publish. Click one to load it back into the editor; review it, then publish to roll back.
• Discard my draft — throw away your unpublished edits and show exactly what is live.
• Download this draft — a single JSON backup of all copy, articles, demos and settings.
• Import a file — accepts one of those backups, or an old blackdice-studio.json draft (which brings its articles across).

---

Questions people ask

Will publishing undo the developers' work? No. Studio only writes content — the copy, articles, images and settings. The page structure, links and forms live in the code and are never overwritten. That is the key difference from the old blackdice-studio.html.

Two of us editing at once? Avoid it. Studio publishes the whole content document, so the last publish wins. Agree who is editing, or publish in turns.

Something looks wrong after publishing. Open History, load the previous snapshot, and publish it.