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

# Installation

> Install VARAHI from the Shopify CLI, a ZIP upload, or the Theme Store — and upgrade safely afterwards.

# Installation

VARAHI is a standard Online Store 2.0 theme. There are three ways to install it, and
all three end with the theme in your **Online Store → Themes** list.

> **Theme Store**
>
> One click. The fastest path.

> **Shopify CLI**
>
> Best if you are developing or updating.

> **ZIP upload**
>
> No CLI required.

***

## From the Theme Store

**1. Purchase or claim the theme**

Add it to your store from the Shopify Theme Store.

**2. Open it in the theme editor**

**Online Store → Themes → VARAHI — Customize**. Start with
[Quickstart](https://varaahi.vritservicespro.com/quickstart.md).

**3. Publish when ready**

Click **Publish**. Your live storefront switches over immediately.

***

## With the Shopify CLI

**1. Install the CLI**

```bash theme={"system"}
npm install -g @shopify/cli @shopify/theme
```

**2. Log in**

```bash theme={"system"}
shopify auth login
```

**3. Clone or push the theme**

```bash theme={"system"}
# Push a local copy to your store as an unpublished theme
shopify theme push --store your-store.myshopify.com

# Or pull an existing VARAHI install to work on locally
shopify theme pull --store your-store.myshopify.com
```

**4. Run a local dev server**

```bash theme={"system"}
shopify theme dev --store your-store.myshopify.com
```

The server prints a local URL and a preview URL. Your local edits hot-reload; the
preview URL is what you use for the theme editor.

**5. Validate before you push**

```bash theme={"system"}
shopify theme check
```

VARAHI ships with **zero theme-check errors** and a single informational warning.
If your copy reports errors, you have introduced them.

> [!WARNING]
>
> Always work on a **duplicate** theme when editing code. **Online Store → Themes → ⋯ → Duplicate**, then push to the copy. Your live theme stays untouched until you
> publish.

***

## From a ZIP file

**1. Download the ZIP**

Get the VARAHI theme ZIP from your purchase or from your developer.

**2. Upload it**

**Online Store → Themes → Add theme — Upload theme**, then choose the ZIP.

**3. Preview, then publish**

Open the uploaded theme, run through [Quickstart](https://varaahi.vritservicespro.com/quickstart.md), then publish.

> [!NOTE]
>
> Shopify only accepts ZIPs whose root folder contains `layout/theme.liquid`. If you
> are packaging the theme yourself, zip the *contents* of the theme folder, not the
> folder itself.

***

## Upgrading

> **What happens to my customisations?**
>
> Sections and settings you changed in the theme editor are stored in your store's
> configuration, not in the theme files — so they survive an update. Changes you made
> to **Liquid, CSS or JavaScript files** do *not* survive, and your theme will be
> flagged as having custom code.

> **What is safe to customise in code?**
>
> See [Code reference](https://varaahi.vritservicespro.com/going-further/code-reference.md). The short version: you can add
> your own `snippets/`, `assets/` and `sections/` files freely, and edit
> `snippets/css-variables.liquid` to add your own tokens. Avoid editing the
> sections themselves — that is what creates upgrade conflicts.

> **How do I keep custom CSS without breaking updates?**
>
> Create a new file `assets/custom.css`, add your rules there, and link it from
> `layout/theme.liquid`. Keep it in one place so re-applying it after an update takes
> seconds. See [Going further](https://varaahi.vritservicespro.com/going-further/code-reference.md).

***

## Requirements

| Requirement | Detail |
| - | - |
| Shopify | Online Store 2.0 (all plans) |
| Theme editor | Required — every feature is configurable without code |
| Browser | Any modern browser; Safari 14+, Chrome 90+, Firefox 90+, Edge 90+ |
| JavaScript | Optional. Motion enhances, it never gates content |
| Fonts | Self-hosted, no Google Fonts request, no third-party connection |

> **[Next: theme architecture](https://varaahi.vritservicespro.com/architecture.md)**
>
> Understand what each file type does before you change anything.


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