Monorepo for Aesthetic.Computer
aesthetic.computer
1# ac-shop - Aesthetic Computer Shopify Tools
2
3CLI tools for managing the Aesthetic Computer Shopify store.
4
5## Quick Reference
6
7### Theme Editing
8
9The shop uses the **Spotlight** theme (ID: `141869547701`).
10
11```bash
12# Pull the theme locally
13npx shopify theme pull --theme 141869547701 --store 3pc8se-sj.myshopify.com --path ./theme
14
15# Push changes (with --allow-live to skip confirmation)
16npx shopify theme push --theme 141869547701 --store 3pc8se-sj.myshopify.com --path ./theme --allow-live
17
18# Push only specific files
19npx shopify theme push --theme 141869547701 --store 3pc8se-sj.myshopify.com --path ./theme --only snippets/buy-buttons.liquid --allow-live
20
21# List available themes
22npx shopify theme list --store 3pc8se-sj.myshopify.com
23```
24
25### Key Theme Files
26
27- `snippets/buy-buttons.liquid` - Buy button text (customized per product type)
28- `sections/header.liquid` - Header navigation
29- `templates/index.json` - Homepage content
30
31### Product Types & Button Text
32
33The buy button text is customized based on `product.type` in `snippets/buy-buttons.liquid`:
34
35| Product Type | Button Text |
36|-------------|-------------|
37| Sketchbook | "Buy this sketchbook" |
38| Book | "Buy this book" |
39| Bike | "Buy this bike" |
40| Shirt | "Buy this shirt" |
41| (record URL) | "Buy this record" |
42| (@jeffrey URL) | "Book @jeffrey now" |
43| Default | "Buy this artwork" |
44
45**Note:** Bikes and shirts also match by handle pattern (`bikes_*`, `shirts_*`) as fallback.
46
47### Product Management CLI
48
49```bash
50# List all products
51node shopify.mjs list
52
53# List with filter
54node shopify.mjs list bikes
55
56# Show product details
57node shopify.mjs show 25.12.4.10.09
58
59# Test API connection
60node shopify.mjs test
61
62# Sync product codes
63node shopify.mjs sync
64```
65
66### Update Sketchbook Descriptions
67
68```bash
69# Updates all 5 @fifi sketchbooks with current description template
70node update-tools.mjs
71```
72
73## Environment Setup
74
75Requires credentials in `../aesthetic-computer-vault/shop/.env`:
76- `SHOPIFY_STORE_DOMAIN` - Store domain (3pc8se-sj.myshopify.com)
77- `SHOPIFY_ADMIN_ACCESS_TOKEN` - Admin API access token
78
79### API Permissions
80
81Manage app permissions at:
82https://admin.shopify.com/store/3pc8se-sj/settings/apps/development
83
84Required scopes:
85- `read_products`, `write_products`
86- `read_themes`, `write_themes`
87- `read_locations` (for inventory management)