/bkend-cookbook

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, bkend cookbook, bkend 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