Skip to content

Update README demo links and clarify setup instructions - #94

Merged
antiv merged 1 commit into
mainfrom
claude/readme-demo-links
Sep 2, 2026
Merged

Update README demo links and clarify setup instructions#94
antiv merged 1 commit into
mainfrom
claude/readme-demo-links

Conversation

@antiv

@antiv antiv commented Sep 2, 2026

Copy link
Copy Markdown
Owner

Summary

Updated the README to improve clarity around the live demo experience and setup flow. Added API key parameter to the murder mystery demo link and clarified that the dashboard requires an account while the demos run without signup.

Changes

  • Rewrote the introductory sentence to emphasize "no signup, no install" for the live demos
  • Added key and lang query parameters to the murder mystery demo link to enable the demo to run
  • Added note that the wizard demo interface is in Serbian
  • Clarified the relationship between the live demos and self-hosted setup: demos are public-facing, while the dashboard behind them requires authentication
  • Improved the transition text to better explain that self-hosted instances behave the same way as the live demos

Details

The changes make it clearer for new users that they can try MATE immediately via the live demos without any setup, while also setting proper expectations that accessing the full dashboard requires creating an account on a self-hosted instance.

https://claude.ai/code/session_01ToCUNy2SqwvfTq4a6xfSk1

The murder mystery link shipped without its widget key. mystery-demo.html
loads the chat widget only `if (key)` is present in the query string, so the
page rendered with nothing to interact with — the worst version of a demo
link, since it looks alive and does nothing. It also defaults to Serbian,
which is the wrong first impression for an English README.

The section headline pointed at the site root, and the root redirects to
/dashboard/workroom, which is behind authentication. A visitor arriving from
GitHub got a login form. The section now leads with the two public surfaces
and says plainly that the dashboard needs an account.

The wizard demo needs no key — it loads the wizard script directly — but its
interface is Serbian, so that is now stated rather than discovered.

The key in the link is the widget's public key, which by design is embedded
in customer pages; the admin key is separate and stays in the dashboard.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01ToCUNy2SqwvfTq4a6xfSk1
@antiv
antiv merged commit 461b161 into main Sep 2, 2026
1 check passed
@antiv
antiv deleted the claude/readme-demo-links branch September 3, 2026 07:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants