> For the complete documentation index, see [llms.txt](https://cryptococo.gitbook.io/cocoshop-theme-development/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cryptococo.gitbook.io/cocoshop-theme-development/getting-started/getting-started.md).

# Getting started

## 1. Create a test store

First, you need to create a test store where you can work on your theme. To do this, go to the following URL and log in to CocoShop: <https://cocoshop.dev/login> (dev: <https://app.devcocoshop.io/ja/login>)

<figure><img src="/files/uJMCHCR7sFTRJc3xzMWn" alt=""><figcaption></figcaption></figure>

After logging in, create your test site by following the on-screen instructions.

<figure><img src="/files/sW12aC0FQCjvSkCR481P" alt=""><figcaption></figcaption></figure>

## 2. Please ask to admin to create api key

Ask Admin (Ropital) to generate Api key.

## 3. Install CocoShop CLI

Now that you have your test store and API key, it's time to set up the CocoShop CLI on your local machine. This command-line tool will help you manage your theme development process. To install the CLI, run the following command:

```bash
npm install -g @cocoshop/cli
```

Once the installation is complete, you can initialize your theme by running:

```bash
cocoshop theme init
```

This command will set up the necessary files and folders for your theme development.

## 4. Set the API key

Next, you need to configure the CocoShop CLI with the API key you generated earlier. Open the `coco.config.json` file in your theme folder and add the API key like this:

```
{
  "apiKey": "your-api-key",
  "secretKey": "your-secret-key",
}
```

Make sure to replace `your-api-key` and `your-secret-key` with the actual API key you generated in step 2.

{% hint style="warning" %}
Please do not ever disclose **coco.config.json** because secretKey is confidential information.
{% endhint %}

## 5. Upload and preview your theme

Now that your theme is set up and configured, you can start working on it. When you're ready to preview your changes, use the following command to upload your theme to your test store:

```bash
cocoshop theme upload
```

Once the upload is complete, you can preview your theme by navigating to the provided URL. This will allow you to see how your theme looks in a live store environment, making it easier to fine-tune your design.

By following these steps, you'll be well on your way to creating a custom theme for your CocoShop store. Happy theme development👋<br>

{% embed url="<https://discord.gg/Ywa4krvgb5>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://cryptococo.gitbook.io/cocoshop-theme-development/getting-started/getting-started.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.