<< All versions
Skill v1.0.1
currentAutomated scan100/100popup-studio-ai/bkit-claude-code/bkend-cookbook
1 files
──Details
PublishedJune 16, 2026 at 09:38 PM
Content Hashsha256:ea88cad758ec2391...
Git SHAf0775451b66c
Bump Typepatch
──Files
Files (1 file, 3.5 KB)
SKILL.md3.5 KBactive
SKILL.md · 92 lines · 3.5 KB
version: "1.0.1" name: bkend-cookbook classification: capability classification-reason: Pattern guidance may overlap with model's built-in knowledge as it improves deprecation-risk: medium effort: medium description: | bkend.ai project tutorials (todo to SaaS) and common error troubleshooting. Triggers: bkend tutorial, cookbook, troubleshooting, 튜토리얼, 에러 해결. user-invocable: false agent: bkit:bkend-expert allowed-tools:
- Read
- Write
- Edit
- Glob
- Grep
- Bash
- mcp__bkend__*
imports:
- ${PLUGIN_ROOT}/templates/shared/bkend-patterns.md
bkend.ai Cookbook & Troubleshooting
Single Project Guides
| Project | Level | Key Features | |
|---|---|---|---|
| Todo App | Beginner | Basic CRUD, state management | |
| Note App | Beginner | Rich text, categories | |
| Blog | Intermediate | Posts, tags, file upload | |
| Chat App | Intermediate | Real-time messaging | |
| E-commerce | Intermediate | Products, orders, payments | |
| Booking System | Intermediate | Reservations, calendar | |
| Social Feed | Advanced | Posts, follows, feeds | |
| Dashboard | Advanced | Charts, analytics, roles | |
| Multi-tenant | Advanced | Organization-scoped data | |
| SaaS Starter | Advanced | Subscriptions, billing, onboarding |
Full Guide Projects (4, each with quick-start + 7 chapters)
| Project | Auth | Core CRUD | Files | Advanced | AI | |
|---|---|---|---|---|---|---|
| Blog | Email/Social | Articles, Tags | Images | Bookmarks | AI summary | |
| Recipe App | Email/Social | Recipes, Ingredients | Photos | Meal Plan, Shopping List | AI recommendations | |
| Shopping Mall | Email/Social | Stores, Products, Orders | Product images | Reviews | AI search | |
| Social Network | Email/Social | Profiles, Posts | Media | Follows, Feeds | AI recommendations |
Common Implementation Pattern
1. Auth setup (email + social login)2. Core CRUD (main data tables)3. File upload (images/media)4. Advanced features (search, filters, relationships)5. AI integration (recommendations, summaries)6. Troubleshooting & optimization
Troubleshooting Quick Reference
| Error | Cause | Solution | |
|---|---|---|---|
| 401 Unauthorized | Token expired | POST /v1/auth/refresh | |
| 403 Forbidden | Insufficient permissions | Check RBAC settings | |
| 404 Not Found | Wrong path/ID | Verify endpoint and environment | |
| 409 Conflict | Unique field duplicate | Check duplicate data | |
| 429 Rate Limit | Request limit exceeded (100/h) | Check Retry-After header | |
| CORS Error | Domain not registered | Register in bkend console | |
| MCP Connection Failed | OAuth incomplete | Complete browser auth | |
| Schema Validation | BSON type mismatch | Check schema with backend_table_get |
FAQ
| Question | Answer | |
|---|---|---|
| Table not visible | Check environment (dev/staging/prod) | |
| MCP tools not showing | Run claude mcp list to verify connection | |
| Social login not working | Check Provider settings in console | |
| File upload fails | Verify size limits (image 10MB, video 100MB) | |
| Slow queries | Add indexes via backend_index_manage | |
| Data not syncing | Check x-environment header matches |
Official Documentation (Live Reference)
For the latest cookbook and troubleshooting, use WebFetch:
- Cookbooks: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/cookbooks/blog/01-quick-start.md
- Troubleshooting: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/troubleshooting/01-common-errors.md
- Full TOC: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md