> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Import the demo content

> Download the Kelvin demo kit and set up a store like the demo in about 30 minutes.

A fresh install of Kelvin shows Shopify's drawn placeholders instead of sample products, so your own catalog shows from day one. To start from the full demo instead, for practice, a client preview or a faster launch, download the **Kelvin demo kit** and import it into a new or development store.

> [card] [Download the Kelvin demo kit](https://drive.google.com/file/d/1AL651_FibuOdxXI0r_L-n8p7GMH6I2tl/view?usp=sharing)
>
> Version 0.1.0, a ZIP of about 84 MB: the pre-configured theme, the demo catalog, the photographs and films, the importer and a product CSV.

> [!TIP]
>
> The kit is on Google Drive. Click **Download** at the top right of the Drive page. If Drive says it can't scan the file for viruses, click **Download anyway**.

> [!NOTE]
>
> A Shopify theme can't create products, pages or menus, so it can't import its own demo content. The kit's **importer** does it instead: a small script you run once on your computer, which adds everything to your store through Shopify's own command line tool.

## What is in the demo kit

| Folder | What it is |
| - | - |
| `theme/kelvin-demo-theme-0.1.0.zip` | Kelvin with every section filled in: the home page sections, the vertical film strip, the PC Builder and compare pages, gift wrap and Care+ plans in the cart, and the logo text. |
| `setup/` | The importer (`setup.mjs`) and its `package.json`. |
| `data/catalogue.json` | What the importer creates: 57 products (some are add-ons hidden from search, such as the Care+ plans, gift wrap and PC assembly), 23 collections, 10 pages, two blogs with 13 articles, the menus, 58 photographs, 15 films and a sample 3D model. |
| `products/kelvin-demo-products.csv` | The products in Shopify's import format, for setting up by hand. |
| `media/` | Copies of the 58 photographs, 15 film posters and 14 films the demo uses, with `media.json` listing each file's source and author. The importer uploads the films from here, already in a format Shopify can process. |
| `CREDITS.md` | Where every photograph (Unsplash) and film (Pexels) comes from. |
| `README.md` | The full setup guide. |

Keep the `media` folder next to `setup`: the importer reads the films from it.

## Import with the importer (about 30 minutes)

**1. Unzip the kit**

Unzip the kit anywhere on your computer.

**2. Install what the importer needs**

You need [Node.js](https://nodejs.org) 22 or newer. Nothing else: the films in `media/films` are ready to upload. (Only if the `media` folder is missing does the importer download the films from Pexels instead, and then it needs [ffmpeg](https://ffmpeg.org) to rewrite the ones Shopify cannot process.)

**3. Run the importer**

In a terminal, open the kit's `setup` folder and run:

```bash theme={null}
npm install
node setup.mjs your-store.myshopify.com auth
node setup.mjs your-store.myshopify.com
```

The first command installs Shopify's command line tool for this folder. The second opens your browser once to approve the access the importer needs. The third creates:

* the metafield definitions: the `specs` spec rows (which also feed the compare table and the PC Builder's compatibility checks), product ratings, Care+ plans and article reading time;
* color swatches linked to each product's Color option;
* a warehouse and three stores with local pickup;
* the products, with photographs, stock at each location, specs, PC part data and the Care+ monthly selling plan;
* the collections, pages, blogs and menus;
* the section photographs and films in **Content → Files**.

Shopify fetches the photographs and film posters from Unsplash and Pexels itself, and the films are uploaded from `media/films`. If a photograph's link ever stops working, upload its copy from `media/` under **Content → Files**, keeping the file name. It is safe to run again: anything that already exists is reused. A log goes to `setup/logs/`. To see what it would create without touching a store, run `node setup.mjs - check`.

**4. Upload the demo theme**

In the Shopify admin go to **Online Store → Themes**, then under Draft themes click **Import → Upload zip file** and choose `theme/kelvin-demo-theme-0.1.0.zip`. Click **Preview** to check it, then **Publish** when you are ready. Development stores show a password page first; the password is under **Online Store → Preferences**.

![The Upload zip file option](https://mintcdn.com/kwebby/QKNMzt7KPy_yk6ai/images/kelvin/admin-upload.webp?fit=max\&auto=format\&n=QKNMzt7KPy_yk6ai\&q=85\&s=c31ead51d4f29e06d7a6bf2f8614bccb)

1 Import · 2 Upload zip file

> [!WARNING]
>
> The importer replaces the items in your store's **main menu** and footer menus, and adds store locations. Run it on a new or development store, not on a live shop.

Run the importer before uploading the theme: the theme finds its photographs and films by file name. If the theme went up first and some media are missing, upload the theme ZIP again.

> [!NOTE]
>
> **Films on the Basic plan:** Shopify accepts at most 10 videos a week on the Basic plan, and the demo uses 14. The importer uploads the hero and the vertical films first, then stops at the limit and says so; those sections show each film's poster until the rest are uploaded. A week later, run `node setup.mjs your-store.myshopify.com films`, then upload the theme ZIP again.

## What the kit does not do

* **Gift card product:** Shopify only creates gift cards once gift cards are activated in your store's settings. Create a product with the handle `gift-card`, choose Gift card as the product type, and add the denominations you want.
* **Quantity price breaks and the quick order list:** these need a B2B catalog. See [Quick order and B2B](https://docs.kwebby.com/kelvin/guides/quick-order-and-b2b.md).
* **Frequently bought together:** complementary products come from the Search & Discovery app; add them there.
* **Filters:** add them in Search & Discovery: Availability, Price, Brand, Product type, Color (as swatches), then the `specs` metafields Socket, Memory type, Form factor, Video memory, Wattage and Water resistance. See [Filters with Search & Discovery](https://docs.kwebby.com/kelvin/guides/search-and-discovery-filters.md).
* **Charging Care+ monthly:** the importer creates the selling plan, so the plan shows on the product and in the cart. Charging it every month at checkout needs a subscriptions app.

## Import by hand

No command line? Create the product metafield definitions in **Settings → Custom data → Products** (each CSV column header shows the namespace and key, such as `product.metafields.specs.socket`; turn storefront access on), then import `products/kelvin-demo-products.csv` in **Products → Import**. The CSV carries only the plain text, number and true or false metafields: lists, ratings, Care+ plans and the gaming PC's parts need the importer. Collections, locations, pages, blogs, menus and the section media are much quicker with the importer; their full list is in `data/catalogue.json`.

> [!WARNING]
>
> The demo photographs come from Unsplash and the films from Pexels (sources in `CREDITS.md`, which also covers the copies in `media/`). They are for demo and preview stores only. Replace them with photographs and films of your own products before you sell.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.