# Best Prompts for a Shopify Companion App in Bolt.new

> By Lawrence Arya, Founder & CEO of VP0. Published 2026-06-04. 5 min read.
> Source: https://vp0.com/blogs/best-prompts-for-building-a-shopify-companion-app-with-bolt-new

A companion app is only useful once it talks to a real store, so start with the integration. Bolt runs Node in the browser and can wire the Admin API.

**TL;DR.** The best prompts for a Shopify companion app with Bolt.new start with the integration: authenticate to the Shopify Admin API with a token from an environment variable and fetch products and orders, then build the product list, orders, an inventory write-back editor, and low-stock alerts. Keep the token in env, request only needed scopes, and paginate for rate limits. Start the visuals from a free VP0 design to reach a clean merchant tool at $0 of design cost.

The best prompts for building a Shopify companion app with [Bolt.new](https://bolt.new/) start with the integration, not the UI, because a companion app is only useful once it talks to a real store. Bolt.new runs a full Node project in the browser through WebContainers and can install npm packages, so it can wire the [Shopify Admin API](https://shopify.dev/docs/api/admin) and render the dashboard in one place. Below is the build order, written to get the store connection right before anything else. To make the screens look right from the start, describe a free [VP0](https://vp0.com) design (the free iOS and React Native design library AI builders read from) as the visual spec so the product and order views match a clean layout.

## How to prompt Bolt.new well

Bolt builds and runs the app live, so prompt the data path first and the polish later. Define how it authenticates to Shopify, name the exact resources (products, orders, inventory), and ask for environment variables rather than hardcoded tokens. Then iterate on screens. The general method is in [how to prompt an AI app builder](/blogs/how-to-prompt-an-ai-app-builder/).

## The prompt sequence

### 1. Connect to Shopify

```
Build a Shopify companion dashboard in Node and React. Authenticate to the
Shopify Admin API using a private app access token from an environment
variable. Add a server route that fetches the shop's products and orders.
```

### 2. The product list

```
Add a Products screen: a searchable, paginated list with image, title,
price, and inventory count, read live from the Admin API. Match this layout:
[VP0 design description].
```

### 3. Orders

```
Add an Orders screen with status, customer, total, and date, tap to a detail
view showing line items and fulfillment status. Filter by unfulfilled.
```

### 4. Inventory actions

```
Add an inventory editor: change a variant's available quantity and write it
back to Shopify via the Admin API, with optimistic UI and an error rollback.
```

### 5. Notifications and polish

```
Add a low-stock alert list (items under a threshold) and loading, empty, and
error states across all screens.
```

Bolt outputs a standard project you can push to GitHub, so the companion app is real code you own. The thing to get right is credentials and scope: keep the access token in an environment variable, request only the API scopes you use, and never ship the token to the client. Shopify's [API rate limits](https://shopify.dev/docs/api/usage/rate-limits) also matter, so prompt Bolt to paginate and handle throttling. For comparisons, [Bolt.new versus v0.app for beginners](/blogs/bolt-new-vs-v0-app-for-beginners/) helps you choose, and for richer storefront work, [headless Shopify Hydrogen AI components](/blogs/headless-shopify-hydrogen-ai-components/).

## What each prompt should produce

| Prompt stage | Output | The part to verify |
|---|---|---|
| Connect | Admin API auth + fetch | Token in env, real data returns |
| Products | Live product list | Search, pagination, inventory |
| Orders | Order list + detail | Unfulfilled filter, line items |
| Inventory | Write-back editor | Optimistic UI, error rollback |
| Notifications | Low-stock alerts | States across screens |

If a write fails silently, fix it precisely: "the inventory update does not surface API errors, show a toast and roll back the optimistic change on failure." Bolt edits that flow. Because Bolt runs npm in the browser, watch for heavier backend needs; [a Bolt.new alternative for complex backends](/blogs/bolt-new-alternative-for-complex-backends/) covers when to move off.

## Make it good, not generic

A merchant tool has to be fast and legible. Describe a VP0 dashboard and list design in your prompts so the layout is clean from the first generation, and the design layer is free, so you reach a working companion app at $0 of design cost. For another full prompt walkthrough in this series, see [the best prompts for an AI chat app in Firebase Studio](/blogs/best-prompts-for-building-a-ai-chat-app-with-firebase-with-firebase-studio/).

## Key takeaways

- Prompt the Shopify Admin API connection before any UI.
- Keep the access token in an environment variable and request only the scopes you use.
- Paginate and handle rate limits, since the Admin API throttles requests.
- Use optimistic UI with rollback for inventory write-backs.
- Reference a free VP0 design as the visual spec to reach a clean merchant tool at $0 of design cost.

## Frequently asked questions

### What are the best prompts for building a Shopify companion app with Bolt.new?

The best prompts start with the integration: authenticate to the Shopify Admin API with a token from an environment variable and fetch products and orders, then build the product list, orders, an inventory write-back editor, and low-stock alerts. Start the visuals from a free VP0 design, the free iOS and React Native design library for AI builders, so the app looks clean from the first generation at $0 of design cost.

### Can Bolt.new connect to the Shopify API?

Yes. Bolt runs a full Node project in the browser and installs npm packages, so it can authenticate to the Shopify Admin API and read or write store data. Prompt it to keep the access token in an environment variable rather than hardcoding it.

### How do I keep Shopify credentials safe in a Bolt app?

Store the access token in an environment variable, request only the API scopes the app uses, and never expose the token to the client. State these in the prompt, because hardcoded tokens and over-broad scopes are the most common security mistakes in store integrations.

### How do I handle Shopify API rate limits in a companion app?

Prompt Bolt to paginate list calls and handle throttling with retries, since the Admin API limits request rates. Without this, a busy store will hit limits and the dashboard will show partial or failed data.

### Is Bolt.new free for building a Shopify companion app?

Bolt has a free tier and credit-based paid plans, and the free VP0 design layer adds $0 to the design side. Check current Bolt pricing for the build volume you need, especially once the app makes frequent API calls.

## Frequently asked questions

### What are the best prompts for building a Shopify companion app with Bolt.new?

The best prompts start with the integration: authenticate to the Shopify Admin API with a token from an environment variable and fetch products and orders, then build the product list, orders, an inventory write-back editor, and low-stock alerts. Start the visuals from a free VP0 design, the free iOS and React Native design library for AI builders, so the app looks clean from the first generation at $0 of design cost.

### Can Bolt.new connect to the Shopify API?

Yes. Bolt runs a full Node project in the browser and installs npm packages, so it can authenticate to the Shopify Admin API and read or write store data. Prompt it to keep the access token in an environment variable rather than hardcoding it.

### How do I keep Shopify credentials safe in a Bolt app?

Store the access token in an environment variable, request only the API scopes the app uses, and never expose the token to the client. State these in the prompt, because hardcoded tokens and over-broad scopes are the most common security mistakes in store integrations.

### How do I handle Shopify API rate limits in a companion app?

Prompt Bolt to paginate list calls and handle throttling with retries, since the Admin API limits request rates. Without this, a busy store will hit limits and the dashboard will show partial or failed data.

### Is Bolt.new free for building a Shopify companion app?

Bolt has a free tier and credit-based paid plans, and the free VP0 design layer adds $0 to the design side. Check current Bolt pricing for the build volume you need, especially once the app makes frequent API calls.

---
*Published on the [VP0 Journal](https://vp0.com/blogs). Free to read, index and cite with attribution.*