coursecode 0.1.7 → 0.1.8

package/README.md

@@ -1,21 +1,23 @@
 # CourseCode
 
-**AI-first course authoring: create interactive e-learning without writing code, then deploy to any LMS format.**
+**Open-source, local-first course authoring with AI help — no coding required to start, full code control when you need it.**
 
-Drop in your existing PDFs, Word docs, or PowerPoints — AI converts them into complete, interactive courses. No vendor lock-in, no subscriptions. Your content, your code, deployed to any LMS.
+CourseCode creates real project files you can inspect, version, and edit directly — with a predictable, file-based workflow instead of a black-box GUI.
+
+Bring your own PDFs, Word docs, or PowerPoints, use AI to accelerate authoring, and deploy to any LMS format without vendor lock-in or subscriptions.
 
 ## Start Here
 
-If you're creating courses (non-technical or technical), use the **[User Guide](framework/docs/USER_GUIDE.md)** as your primary documentation.
+Start with the workflow that fits you:
 
-- **Course authors (non-technical):** Start with the User Guide for step-by-step workflows
-- **Course authors (technical):** The User Guide is still the best starting point, then use advanced docs as needed
+- **Course authors (prefer buttons and guided setup):** Start with **[CourseCode Desktop](https://coursecodedesktop.com)** if you want the easiest path and do not want to deal with Node.js or terminal setup
+- **Course authors (prefer editing files and running commands):** Start with the **[User Guide](framework/docs/USER_GUIDE.md)** in this repo for the framework workflow
 - **AI assistants:** Use the AI-focused docs in `framework/docs/` (for example `COURSE_AUTHORING_GUIDE.md` and `FRAMEWORK_GUIDE.md`)
 
 ## Features
 
 - **MCP integration**: AI connects directly to your course — previews, screenshots, linting, and testing without manual file sharing
-- **No code writing required**: Describe what you want and let AI build slides, interactions, and structure
+- **No coding required to start**: Describe what you want and let AI help build slides, interactions, and structure
 - **Full LMS integration**: SCORM 1.2, SCORM 2004, cmi5, and LTI with complete tracking records
 - **AI-assisted authoring workflow**: Structured guides and MCP tools for faster course development
 - **Rich UI components**: Images, video, accordions, tabs, and custom sandboxed HTML/JS embeds
@@ -26,13 +28,17 @@ If you're creating courses (non-technical or technical), use the **[User Guide](
 - **Themeable design**: CSS custom properties for easy brand customization
 - **Custom endpoints**: Optional webhooks for error reporting and learning record storage
 - **Live preview**: Visual editing, status dashboard, config panels, catalog browser, and full LMS simulation with debug tools
-- **[CourseCode Cloud](https://www.coursecodecloud.com)**: Deploy from CLI, share preview links, download any LMS format on demand — no rebuilds
-- **CourseCode Desktop**: Native app for Mac and Windows with AI-assisted editing and built-in preview
+- **[CourseCode Cloud](https://coursecodecloud.com)**: Deploy from CLI, share preview links, download any LMS format on demand — no rebuilds
+- **[CourseCode Desktop](https://coursecodedesktop.com)**: Native app for Mac and Windows with AI-assisted editing and built-in preview
 
 ---
 
 ## Installation
 
+This section is for the **CourseCode Framework CLI** (file-based workflow using Node.js and terminal commands).
+
+If you want the easiest setup with buttons and guided steps, use **[CourseCode Desktop](https://coursecodedesktop.com)** instead.
+
 ### Required
 
 Install [Node.js](https://nodejs.org/) (v18 or later), then run:
@@ -65,7 +71,7 @@ Open `http://localhost:4173` to view and edit your course.
 
 The example course included with every new project is a complete guide to using CourseCode.
 
-**New to CourseCode?** Start with the [User Guide](framework/docs/USER_GUIDE.md). It is the primary guide for both non-technical and technical course authors.
+**New to CourseCode?** If you want the easiest setup, start with **[CourseCode Desktop](https://coursecodedesktop.com)**. If you're using the framework CLI, start with the [User Guide](framework/docs/USER_GUIDE.md).
 
 ---
 
@@ -179,7 +185,7 @@ The preview server provides:
 
 When ready, deploy:
 
-**With [CourseCode Cloud](https://www.coursecodecloud.com)**: Push your course and get a live link. Cloud handles hosting, generates any LMS format on demand, and gives you sharable preview links with optional password protection. No ZIP files, no manual uploads.
+**With [CourseCode Cloud](https://coursecodecloud.com)**: Push your course and get a live link. Cloud handles hosting, generates any LMS format on demand, and gives you sharable preview links with optional password protection. No ZIP files, no manual uploads.
 
 ```bash
 coursecode deploy
@@ -218,7 +224,7 @@ For the full command list and deployment options, see the [User Guide](framework
 
 ## UI Components
 
-Build engaging slides with interactive elements. No coding required — your AI assistant handles the implementation.
+Build engaging slides with interactive elements. Start with AI assistance, then edit the generated files directly whenever you want more control.
 
 ### Media & Widgets
 

package/framework/css/interactions/interactive-image.css

@@ -61,7 +61,7 @@
 .interactive-image-hotspot[data-color="primary"] { --hotspot-color: var(--color-primary, #14213d); }
 .interactive-image-hotspot[data-color="secondary"] { --hotspot-color: var(--color-secondary, #f18701); }
 .interactive-image-hotspot[data-color="success"] { --hotspot-color: var(--color-success, #1d7648); }
-.interactive-image-hotspot[data-color="danger"] { --hotspot-color: var(--color-danger, #f35b04); }
+.interactive-image-hotspot[data-color="danger"] { --hotspot-color: var(--color-danger, #c7322b); }
 .interactive-image-hotspot[data-color="warning"] { --hotspot-color: var(--color-warning, #f7b801); }
 .interactive-image-hotspot[data-color="info"] { --hotspot-color: var(--color-info, #4a6fa5); }
 .interactive-image-hotspot[data-color="light"] { --hotspot-color: var(--color-gray-50, #fafafa); }
@@ -71,7 +71,7 @@
 .interactive-image-hotspot[data-viewed-color="primary"] { --viewed-color: var(--color-primary, #14213d); }
 .interactive-image-hotspot[data-viewed-color="secondary"] { --viewed-color: var(--color-secondary, #f18701); }
 .interactive-image-hotspot[data-viewed-color="success"] { --viewed-color: var(--color-success, #1d7648); }
-.interactive-image-hotspot[data-viewed-color="danger"] { --viewed-color: var(--color-danger, #f35b04); }
+.interactive-image-hotspot[data-viewed-color="danger"] { --viewed-color: var(--color-danger, #c7322b); }
 .interactive-image-hotspot[data-viewed-color="warning"] { --viewed-color: var(--color-warning, #f7b801); }
 .interactive-image-hotspot[data-viewed-color="info"] { --viewed-color: var(--color-info, #4a6fa5); }
 .interactive-image-hotspot[data-viewed-color="light"] { --viewed-color: var(--color-gray-50, #fafafa); }

package/framework/docs/COURSE_AUTHORING_GUIDE.md

@@ -1688,6 +1688,8 @@ environment: {
 
 Three optional, config-driven tools for outbound communication. Each activates when its `endpoint` is set — no code changes needed.
 
+> **CourseCode Cloud (AI note):** These `environment.*` endpoint settings are the **manual/self-hosted fallback**. On cloud-served launches, CourseCode Cloud injects `cc-*` meta tags into `index.html`, and the framework uses those values instead (override). This is intentional zero-config behavior for cloud error/data/channel wiring.
+
 | Tool | What it sends | Transport | Example backend |
 |------|--------------|-----------|-----------------|
 | **Error Reporter** | Framework errors (`*:error` events) | POST per error (60s dedup) | `cloudflare-error-worker.js` |
@@ -1711,6 +1713,8 @@ eventBus.on('channel:message', (data) => { /* any JSON */ });
 All example backends are in `framework/docs/examples/`.
 
 > **Local dev:** Error and data reporters are automatically disabled during watch builds (`coursecode preview`, `coursecode dev`). Production builds (`coursecode build`) send reports normally.
+>
+> **Cloud precedence:** Cloud-injected meta tags override `course-config.js` endpoint settings for these tools. If you need custom routing/fanout, prefer doing it server-side from your cloud ingestion endpoint.
 
 ---
 

package/framework/docs/USER_GUIDE.md

@@ -605,11 +605,37 @@ coursecode build --format scorm1.2-proxy
 CourseCode Cloud is the simplest deployment option. Upload your course once and the cloud handles everything:
 
 ```bash
+coursecode login     # First time only: sign in to CourseCode Cloud
 coursecode deploy    # Build + upload to cloud
 ```
 
 **How it works:** Your course is built once as a universal package. The cloud can generate a format-specific ZIP (SCORM 1.2, SCORM 2004, cmi5, etc.) on demand — no rebuilding required. You never need to set a format in `course-config.js` for cloud-deployed courses.
 
+Cloud-served launches also auto-configure runtime error reporting, data reporting, and channel relay endpoints (zero-config cloud wiring).
+If you configured manual endpoints in `course-config.js` for self-hosted workflows, Cloud launches override them with cloud-injected runtime config.
+
+**What CourseCode Cloud helps with (plain English):**
+- Host your course online so learners/reviewers can access it without you manually hosting files
+- Generate the LMS package you need later (SCORM/cmi5) from the same upload
+- Share preview links for stakeholder review
+- Manage deployment updates without rebuilding separate packages for each LMS format
+- Provide cloud-managed runtime services (reporting/channel) without extra endpoint setup in your course files
+
+**Typical Cloud workflow (CLI):**
+1. Run `coursecode login` once and sign in.
+2. Run `coursecode deploy` from your project folder.
+3. Open the CourseCode Cloud course page/dashboard link shown after deploy.
+4. Use Cloud preview links for review.
+5. Download the LMS format you need from Cloud when you're ready to deliver.
+
+**Prefer a GUI instead of the terminal?**
+- Use **CourseCode Desktop** for the same project workflow with buttons for Preview / Export / Deploy.
+- Desktop docs: `coursecode-desktop/USER_GUIDE.md`
+
+**When to use Cloud vs local export:**
+- Use **local export** if you just need a ZIP to upload manually and don't need hosted previews or cloud services.
+- Use **Cloud** if you want easier sharing, hosted delivery workflows, or format downloads later without rebuilding.
+
 **Benefits:**
 - **No format decisions** — download the right ZIP for any LMS directly from the cloud
 - **Instant updates** — redeploy and all future launches get the new version

package/framework/docs/examples/cloudflare-channel-relay.js

@@ -3,6 +3,9 @@
  * 
  * Content-agnostic message fan-out. Receives JSON via POST, broadcasts to all
  * connected SSE clients on the same channel. Does not parse or interpret messages.
+ * Self-hosted/manual relay example: on CourseCode Cloud, runtime channel endpoint/id are injected
+ * by the platform and override course-config.js endpoint values.
+ * Use this either for self-hosted relay infrastructure, or as a cloud-managed relay implementation/reference.
  * 
  * SETUP:
  * 1. Create a Cloudflare account and go to Workers & Pages

package/framework/docs/examples/cloudflare-data-worker.js

@@ -3,6 +3,9 @@
  * 
  * Receives batched learning records (assessments, objectives, interactions) 
  * from courses and stores them for analytics or forwards to your data warehouse.
+ * Self-hosted/manual endpoint example: on CourseCode Cloud, runtime endpoints/API key are injected
+ * by the platform and override course-config.js endpoint values.
+ * Use this either for self-hosted telemetry, or as a downstream target if Cloud fans out records server-side.
  * 
  * SETUP:
  * 1. Create a Cloudflare account and go to Workers & Pages

package/framework/docs/examples/cloudflare-error-worker.js

@@ -3,6 +3,9 @@
  * 
  * Deploy this worker to receive error reports and user issue reports from courses
  * and send email alerts. The API key stays server-side, so it's never exposed in the course.
+ * Self-hosted/manual endpoint example: on CourseCode Cloud, runtime endpoints/API key are injected
+ * by the platform and override course-config.js endpoint values.
+ * Use this either for self-hosted telemetry, or as a downstream target if Cloud fans out reports server-side.
  * 
  * SETUP:
  * 1. Create a Cloudflare account and go to Workers & Pages

package/lib/cloud.js

@@ -22,7 +22,7 @@ const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'packa
 // CONSTANTS
 // =============================================================================
 
-const DEFAULT_CLOUD_URL = 'https://www.coursecodecloud.com';
+const DEFAULT_CLOUD_URL = 'https://coursecodecloud.com';
 const LOCAL_CLOUD_URL = 'http://localhost:3000';
 let useLocal = false;
 const CREDENTIALS_DIR = path.join(os.homedir(), '.coursecode');

package/lib/stub-player/styles/_base.css

@@ -25,7 +25,7 @@
             --color-warning-bright: color-mix(in srgb, var(--color-warning) 70%, var(--color-accent));
             --color-accent: #f7b801;
 
-            --color-danger: #f35b04;
+            --color-danger: #c7322b;
             --color-danger-soft: color-mix(in srgb, var(--color-danger) 55%, var(--color-white));
             --color-black: #000;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coursecode",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Multi-format course authoring framework with CLI tools (SCORM 2004, SCORM 1.2, cmi5, LTI 1.3)",
   "type": "module",
   "bin": {

package/template/course/course-config.js

@@ -70,6 +70,8 @@
  *   Sends framework errors to a webhook for email alerts. Disabled if endpoint is missing.
  *   enableUserReports adds "Report Issue" button to settings menu (default: true when endpoint set).
  *   Use with Cloudflare Worker to keep API keys server-side.
+ *   CourseCode Cloud launches override manual endpoint config via injected <meta name="cc-*"> tags
+ *   (zero-config cloud wiring). Treat this as a self-hosted/manual fallback.
  *
  * LMS COMPATIBILITY PROFILE (environment.lmsCompatibilityMode):
  *   'auto' (default): choose profile by format (strict-scorm12 / conservative-scorm2004 / modern-http)