Merge pull request #88 from cloudadoption/cloneit-app

clone-it app

Author: kunwarsaluja

tools/cloneit/README.md

@@ -0,0 +1,80 @@
+# CloneIt
+
+Clone the demo site to create a new repoless AEM site with one click.
+
+## What It Does
+
+CloneIt creates a new repoless site by:
+
+1. **Creating DA folder** – Creates the new site folder in DA with a minimal `index.html`.
+2. **Copying DA config** – Fetches repo-level config from the baseline via [DA Config GET](https://opensource.adobe.com/da-admin/#tag/Config/operation/getConfig) and creates it for the new site via [DA Config POST](https://opensource.adobe.com/da-admin/#tag/Config/operation/createConfig). Skipped if baseline has no config.
+3. **Copying DA content** – Recursively copies all files from `cloudadoption/diyfire` to the new site folder, skipping `drafts` and `demo-docs`. Uses the [DA List API](https://admin.da.live/list) to discover all files, then the [DA Copy API](https://opensource.adobe.com/da-admin/#tag/Copy) per file (the Copy API does not recurse into folders). If copy fails, falls back to updating the minimal `index.html`.
+4. **Creating the AEM site config** – Fetches the baseline diyfire configuration from the [AEM Admin API](https://www.aem.live/docs/admin.html#tag/siteConfig/operation/createSiteSite), copies only code, sidekick, and headers, sets content to the new DA URL, and creates the site via `PUT /config/{org}/sites/{site}.json`
+5. **Copying query index config** – Fetches the baseline `query.yaml` and creates it for the new site. Skipped if the baseline has no index config.
+
+The new site shares the same codebase (diyfire) and uses `https://content.da.live/cloudadoption/{sitename}/` as its content source.
+
+## How to Use
+
+1. Open the app from the AEM Sidekick (CloneIt button) or navigate to `/tools/cloneit/cloneit.html`
+2. **Authentication** – The app must be opened from a DA context (e.g. da.live) to obtain the bearer token for API calls
+3. Enter a **site name** (lowercase, numbers and hyphens only, max 50 chars, e.g. `my-new-site`). Reserved names like `admin`, `api`, `config` are blocked.
+4. Click **Clone Site**
+5. Access your new site at `https://main--{sitename}--cloudadoption.aem.page`
+6. **Bulk Preview/Publish** (optional) – After a successful clone, click **Bulk Preview/Publish** to copy all content URLs to your clipboard. A modal guides you to the [DA Bulk app](https://da.live/apps/bulk), where you paste the URLs and run preview or publish as needed.
+
+---
+
+## App Structure (for maintainers)
+
+This section describes where things live so the app is easy to follow and change.
+
+### File layout
+
+All CloneIt files live under the project’s `tools/cloneit/` folder:
+
+| File | Role |
+|------|------|
+| `cloneit.html` | Single-page UI: header, config card, progress section, result section, bulk modal, help modal, toast |
+| `cloneit.js` | All app logic: constants, validation, API calls, clone flow, bulk flow, event wiring, init |
+| `cloneit.css` | All styles (no preprocessor). Scoped by section/component class names. |
+| `README.md` | This documentation |
+
+### HTML structure (`cloneit.html`)
+
+- **Header** – Title, subtitle, Help button
+- **Config card** – Site name input, live preview URL, Clone button
+- **Progress section** – Shown during clone: phase, progress bar, status text, file list
+- **Result section** – Success card (summary list, Bulk Preview/Publish button, Preview/DA/Code links) or error card
+- **Bulk modal** – “URLs copied” message and “Open DA Bulk app” button (no in-app bulk API)
+- **Help modal** – What CloneIt does, naming rules, after-clone steps, bulk flow
+- **Toast** – Temporary success/error/info messages
+
+---
+
+## APIs Used
+
+| API | Endpoint | Purpose |
+|-----|----------|---------|
+| DA Admin | `GET /config/cloudadoption/diyfire/` | Fetch baseline repo config |
+| DA Admin | `POST /config/cloudadoption/{site}/` | Create config for new site |
+| DA Admin | `GET /list/cloudadoption/diyfire/{path}` | Discover all files recursively |
+| DA Admin | `POST /copy/cloudadoption/diyfire/{path}` | Copy each file to new site folder |
+| DA Admin | `POST /source/cloudadoption/{site}/index.html` | Fallback: create minimal content if copy fails |
+| AEM Admin | `GET /config/cloudadoption/sites/diyfire.json` | Fetch baseline config |
+| AEM Admin | `PUT /config/cloudadoption/sites/{site}.json` | Create repoless site |
+| AEM Admin | `GET /config/cloudadoption/sites/diyfire/content/query.yaml` | Fetch baseline index config |
+| AEM Admin | `PUT /config/cloudadoption/sites/{site}/content/query.yaml` | Create index config for new site |
+
+## Authentication
+
+Uses the [DA SDK](https://da.live/nx/utils/sdk.js) to obtain a bearer token. The same token works for both AEM Admin API and DA Admin API when the user is authenticated in the DA context.
+
+## References
+
+- [Repoless documentation](https://www.aem.live/docs/repoless)
+- [AEM Admin API – Create Site](https://www.aem.live/docs/admin.html#tag/siteConfig/operation/createSiteSite)
+- [AEM Admin API – Create Index Config](https://www.aem.live/docs/admin.html#tag/indexConfig/operation/createIndexConfig)
+- [DA Admin API – Create Source](https://opensource.adobe.com/da-admin/#tag/Source/operation/createSource)
+- [DA Admin API – Get Config](https://opensource.adobe.com/da-admin/#tag/Config/operation/getConfig)
+- [DA Admin API – Create Config](https://opensource.adobe.com/da-admin/#tag/Config/operation/createConfig)