با UUID از Console، پروژه local به app وصل میشود. scaffold و generated توسط pull/dev sync میشوند.
puzzle init
bashپازل API
mkdir my-shop && cd my-shop
puzzle init <APP-UUID>- repo موجود → clone ممکن است
- app جدید → platform.json + scaffold
platform.json
jsonپازل API
{
"version": "2.0",
"app": {
"id": "550e8400-e29b-41d4-a716-446655440001",
"name": "My Shop",
"slug": "shop"
},
"components": ["api", "panel"],
"services": {
"database": false,
"cache": false
}
}dependency
وابستگی app→app در Console workspace تنظیم میشود، نه در platform.json.
puzzle pull
bashپازل API
puzzle pull- sync فایلهای scaffold
- بهروزرسانی generated/ (types، hooks)
- deps/ — public surface اپهای dependency
ساختار پوشه
textپازل API
my-shop/
├── platform.json
├── api/src/
├── panel/src/
├── generated/ ← ignore
└── deps/ ← اگر dependency داریدنسخهگذاری
- commit: api/src، panel/src، platform.json
- ignore: generated/، node_modules/