---

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/ww-w-ai/bkend-docs/main/en/cookbooks/blog/01-quick-start.md
• Troubleshooting: https://raw.githubusercontent.com/ww-w-ai/bkend-docs/main/en/troubleshooting/01-common-errors.md
• Full TOC: https://raw.githubusercontent.com/ww-w-ai/bkend-docs/main/SUMMARY.md