diff --git a/docs/demo-assets/gbp-test-1200x900.jpg b/docs/demo-assets/gbp-test-1200x900.jpg new file mode 100644 index 0000000..89e092e Binary files /dev/null and b/docs/demo-assets/gbp-test-1200x900.jpg differ diff --git a/docs/demo-assets/quorla-test-9x16.mp4 b/docs/demo-assets/quorla-test-9x16.mp4 new file mode 100644 index 0000000..2e33d20 Binary files /dev/null and b/docs/demo-assets/quorla-test-9x16.mp4 differ diff --git a/docs/demo-recording.md b/docs/demo-recording.md new file mode 100644 index 0000000..51d14fa --- /dev/null +++ b/docs/demo-recording.md @@ -0,0 +1,72 @@ +# Demo videos for the Google and TikTok reviews + +Two short screen recordings (about 3 minutes each) of the live app, app.quorlasocial.com. + +## Before you start (once) + +- **Recorder:** Windows **Snipping Tool** → Record (or Xbox Game Bar: Win + Alt + R). Record the **whole Chrome + window, including the address bar**: Google checks the `client_id` in the URL on its sign-in screen. +- Chrome at full screen width, zoom 100%, close other tabs, hide bookmarks bar (Ctrl+Shift+B). +- No voice needed. Move the mouse slowly and pause ~2 seconds on each important screen. +- Test files are in `docs/demo-assets/`: `quorla-test-9x16.mp4` (8 s vertical) and `gbp-test-1200x900.jpg`. +- Sign in to app.quorlasocial.com first, so the recording starts inside the app. +- Use the client **MetatronCube Software Solutions Canada** throughout. + +--- + +## Video 1: Google (YouTube + Business Profile). Upload to YouTube as **Unlisted** + +1. **Show the homepage.** Go to https://quorlasocial.com, scroll briefly, click **Privacy Policy** in the footer + (pause 2 s), go back. +2. **Show who's signed in.** Go to https://app.quorlasocial.com → **Connections**, pick + *MetatronCube Software Solutions Canada*. +3. **YouTube sign-in.** On the YouTube card click **Disconnect**, then **Connect**. + - Google account chooser → pick the channel's account. + - If Google shows "Google hasn't verified this app": pause 2 s on it (reviewers expect to see it), click + **Advanced → Go to quorlasocial.com (unsafe)**. + - **Consent screen:** pause 3 s so "Quorla" and both YouTube permissions are readable. Hover over the address bar + for 2 s (shows the client_id). Click **Continue / Allow**. + - Back in Quorla: the YouTube card shows the channel name, avatar and subscriber count. Pause 2 s. +4. **Upload a video.** Publishing → **New post** → client *MetatronCube…* → type **Reel/Video** → upload + `quorla-test-9x16.mp4` → caption "Publishing workflow test" → tick **YouTube** only → title + "Quorla demo upload", visibility **Private**, made for kids **No** → date/time 2 minutes from now → + **Save as draft**. +5. **Approve.** On the draft click **Approve**. Wait until the status turns **Published** (refresh after ~1 min), + click **View on youtube**, show the video page on YouTube (pause 3 s). +6. **Business Profile sign-in.** Connections → Google Business Profile → **Disconnect**, then **Connect** → account + chooser → consent screen (pause 3 s, hover address bar) → Allow → choose the **Metatroncube Software Solutions** + location in the dropdown. +7. **Business Profile post.** New post → type **Image** → upload `gbp-test-1200x900.jpg` → short caption → tick + **Google Business Profile** only → button **Learn more**, link https://metatroncubesolutions.com → time 2 min + ahead → Save as draft → **Approve** → wait for **Published**. Then open Google Maps / Search for the business and + show the update (pause 3 s). + *(This post is public. Skip step 7's publish if you don't want another public update; showing the draft and + approve button is acceptable but a completed post is stronger.)* +8. **Disconnect.** Connections → YouTube → **Disconnect** (shows tokens can be removed). End recording. + +Then: upload the file to YouTube **as Unlisted** (any channel), copy the link, send it to Claude. + +--- + +## Video 2: TikTok Direct Post. Upload the MP4 file in TikTok's review form + +Needs a **personal TikTok account set to Private** (Business accounts can't be private, and unreviewed apps can only +Direct Post to private accounts). Claude adds it as a Sandbox target user first. + +1. Connections → TikTok → **Disconnect** (if the business account is connected) → **Connect** → TikTok login with the + private test account → TikTok's consent screen (pause 3 s) → Authorize → back in Quorla, TikTok card shows the + account. Pause 2 s. +2. Publishing → New post → **Reel/Video** → upload `quorla-test-9x16.mp4` → caption → tick **TikTok** only. +3. In the TikTok panel, slowly show (pause on each): + - "Posting to" with the account **name and avatar**. + - **How to post: Post directly.** + - **Who can view this post**: open the dropdown to show there's no preselected option, choose **Only me**. + - **Allow comments / Duet / Stitch** checkboxes. + - Tick **Disclose commercial content**, show the "Your brand" / "Branded content" options and the label text, + then untick it again. + - The **Music Usage Confirmation** sentence at the bottom. +4. Time 2 min ahead → **Save as draft** → **Approve** → wait for **Published** → click **View on tiktok** (or open + the TikTok app/profile) and show the post. End recording. +5. Afterwards reconnect TikTok with the business account (Connections → TikTok → Disconnect → Connect). + +Save as MP4 (Snipping Tool saves MP4). TikTok accepts MP4/MOV; keep it under 50 MB (trim if needed).