shopify-api-integration

• [A Firebase account](https://firebase.google.com/)

• A Firebase project

• [A Shopify partner account](https://www.shopify.com/partners)

• A Shopify app in partner account

• Choose a project staging for Firebase application

```bash

firebase use --add

```

• Configure all settings for Firebase development environment by creating a new file .env inside the packages/functions (copy from .env.example)

```dotenv

# Shopify Configuration

SHOPIFY_API_KEY=

SHOPIFY_SECRET=

SHOPIFY_FIREBASE_API_KEY=

SHOPIFY_SCOPES=read_themes

SHOPIFY_ACCESS_TOKEN_KEY=avada-apps-access-token

# App Configuration

APP_ENV=development

APP_BASE_URL=

```

• Create a file .env.development with content in [packages/assets](/packages/assets)

```dotenv

VITE_SHOPIFY_API_KEY=

VITE_FIREBASE_API_KEY=

VITE_FIREBASE_AUTH_DOMAIN=

VITE_FIREBASE_PROJECT_ID=

VITE_FIREBASE_STORAGE_BUCKET=

VITE_FIREBASE_APP_ID=

VITE_FIREBASE_MEASUREMENT_ID=

```

• Create an empty Firestore database
• Deploy the Firestore default indexes

```bash

firebase deploy --only firestore

```

• To start to develop, please run 2 below commands

```bash

npm run dev

```

```bash

GOOGLE_APPLICATION_CREDENTIALS= firebase serve

```

• All your files must be passed [ESLint](https://eslint.org/):

To setup a git hook before committing to Gitlab, please run:

```bash

cp git-hooks/pre-commit .git/hooks/pre-commit && chmod +x .git/hooks/pre-commit

```

• You can see all logs from your functions by follow commands

```bash

firebase functions:log

```

• You also view in Web interface by access


When you open an embedded app in local, it can throw an error like that


Solution

Install [Disable Content-Security-Policy (CSP)](https://chrome.google.com/webstore/detail/disable-content-security/ieelmcmcagommplceebfedjlakkhpden) to disable CSP in Chromium browers

I got message `Unauthorized` after authentication

Solution

Go https://console.firebase.google.com/u/0/project/{project-id}/settings/serviceaccounts/adminsdk

Click Generate new private key

Use command to export global environment

```bash

export GOOGLE_APPLICATION_CREDENTIALS=

```

I got message `PERMISSION_DENIED: Missing or insufficient permissions`

Solution

Enable permission Service Account Token Creator for user@appspot.gserviceaccount.com


I can't see `FIREBASE_MEASUREMENT_ID` in Firebase project

Solution

You can enable Analytics for your project from Firebase project


This project supports agentic development workflows using Claude Code. See CLAUDE.md for detailed instructions.

Quick Commands

| Command | Description |

|---------|-------------|

| /plan [task] | Create implementation plan for a feature |

| /fix [issue] | Analyze and fix issues |

| /test | Run tests and validate code quality |

| /debug [issue] | Investigate and diagnose problems |

| /impact | Analyze impact before merge request |

| /perf [target] | Audit code for performance issues |

| /translate [feature] | Update translations after adding labels |

Specialized Agents

| Agent | Purpose |

|-------|---------|

| planner | Research and create implementation plans |

| debugger | Investigate issues, analyze logs |

| tester | Run tests, validate quality |

| code-reviewer | Code review with Avada standards |

| security-auditor | Security vulnerability analysis |

| performance-reviewer | Audit performance and costs |

| shopify-app-tester | MR impact and testing checklist |

Recommended Workflows

New Feature:

```

/plan [feature] → implement → /test → /review → /impact

```

Bug Fix:

```

/debug [issue] → /fix → /test

```

Before Merge:

```

/test → /review → /perf → /impact

```

Skills Reference

Skills documentation is available in .claude/skills/ for:

• avada-architecture.md - Project structure and coding standards
• firestore.md - Firestore queries, batching, indexes
• bigquery.md - Partitioning, clustering, cost control
• shopify-api.md - API selection, bulk operations, webhooks
• backend.md - Async patterns, functions config

• [ ] Add testing
• [x] CI/CD
• [ ] Add document