From f06e7880bbe39843de6a16e7ecfdfc88ead02a48 Mon Sep 17 00:00:00 2001 From: Matt Roberts Date: Sun, 31 May 2026 11:39:15 +0100 Subject: [PATCH 1/7] docs: highlight Concerto Playground as the primary quick-start on the homepage Make the in-browser Playground the headline way to get started: a four-way hero path chooser (Playground / language / SDK / CLI) with the Playground featured, a live embedded Playground iframe section near the top, a reworked "Give it a try" flow that leads with the no-install Playground, and a persistent Playground link in the navbar. Co-Authored-By: Claude Opus 4.7 Signed-off-by: Matt Roberts --- docusaurus.config.js | 5 + src/components/HomepageFeatures/index.js | 125 +++++++++++++++--- src/css/custom.css | 159 +++++++++++++++++++++++ 3 files changed, 268 insertions(+), 21 deletions(-) diff --git a/docusaurus.config.js b/docusaurus.config.js index 6251ecd..18ffc37 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -76,6 +76,11 @@ const config = { position: 'right', label: 'Docs', }, + { + href: 'https://concerto-playground.accordproject.org', + label: 'Playground', + position: 'right', + }, { type: 'doc', docId: 'contributing', diff --git a/src/components/HomepageFeatures/index.js b/src/components/HomepageFeatures/index.js index aef7939..323846a 100644 --- a/src/components/HomepageFeatures/index.js +++ b/src/components/HomepageFeatures/index.js @@ -12,22 +12,58 @@ import samples from '../samples'; import styles from './styles.module.css'; +const PLAYGROUND_URL = 'https://concerto-playground.accordproject.org'; + +const startPaths = [ + { + title: 'Try the Playground', + description: 'Write a model and see it compile live — no install.', + href: PLAYGROUND_URL, + target: '_blank', + featured: true, + }, + { + title: 'Learn the language', + description: 'Start with the basics of modeling in Concerto.', + href: '/docs/intro', + target: '_self', + }, + { + title: 'Use the SDK', + description: 'Parse, validate and generate code from JavaScript.', + href: '/docs/api/ref-js-api', + target: '_self', + }, + { + title: 'Use the CLI', + description: 'Validate and compile models from your terminal.', + href: '/docs/tutorials/quick-start', + target: '_self', + }, +]; + +function PathCard({title, description, href, target, featured}) { + const resolvedHref = useBaseUrl(href); + return ( + + {featured && Recommended} +

{title}

+

{description}

+
+ ); +} + function HomeCallToAction() { return ( - <> - - Learn More - - - Quick Start Tutorial - - +
+ {startPaths.map((path, idx) => ( + + ))} +
); } @@ -282,6 +318,38 @@ function CrossPlatform() { ); } +function PlaygroundSection() { + return ( +
+
+ +

+ No install required. Write a .cto model and watch it + compile live to TypeScript, Java, Go, JSON Schema, GraphQL, Protobuf + and more — everything runs client-side in your browser. +

+
+
+ + concerto-playground.accordproject.org +
+