1---2name: popup-studio-ai-bkit-claude-code-bkend-cookbook3description: bkend.ai Cookbook & Troubleshooting4---56# bkend.ai Cookbook & Troubleshooting78## Single Project Guides910| Project | Level | Key Features |11|---------|-------|-------------|12| Todo App | Beginner | Basic CRUD, state management |13| Note App | Beginner | Rich text, categories |14| Blog | Intermediate | Posts, tags, file upload |15| Chat App | Intermediate | Real-time messaging |16| E-commerce | Intermediate | Products, orders, payments |17| Booking System | Intermediate | Reservations, calendar |18| Social Feed | Advanced | Posts, follows, feeds |19| Dashboard | Advanced | Charts, analytics, roles |20| Multi-tenant | Advanced | Organization-scoped data |21| SaaS Starter | Advanced | Subscriptions, billing, onboarding |2223## Full Guide Projects (4, each with quick-start + 7 chapters)2425| Project | Auth | Core CRUD | Files | Advanced | AI |26|---------|------|-----------|-------|----------|-----|27| Blog | Email/Social | Articles, Tags | Images | Bookmarks | AI summary |28| Recipe App | Email/Social | Recipes, Ingredients | Photos | Meal Plan, Shopping List | AI recommendations |29| Shopping Mall | Email/Social | Stores, Products, Orders | Product images | Reviews | AI search |30| Social Network | Email/Social | Profiles, Posts | Media | Follows, Feeds | AI recommendations |3132## Common Implementation Pattern3334```351. Auth setup (email + social login)362. Core CRUD (main data tables)373. File upload (images/media)384. Advanced features (search, filters, relationships)395. AI integration (recommendations, summaries)406. Troubleshooting & optimization41```4243## Troubleshooting Quick Reference4445| Error | Cause | Solution |46|-------|-------|----------|47| 401 Unauthorized | Token expired | POST /v1/auth/refresh |48| 403 Forbidden | Insufficient permissions | Check RBAC settings |49| 404 Not Found | Wrong path/ID | Verify endpoint and environment |50| 409 Conflict | Unique field duplicate | Check duplicate data |51| 429 Rate Limit | Request limit exceeded (100/h) | Check Retry-After header |52| CORS Error | Domain not registered | Register in bkend console |53| MCP Connection Failed | OAuth incomplete | Complete browser auth |54| Schema Validation | BSON type mismatch | Check schema with backend_table_get |5556## FAQ5758| Question | Answer |59|----------|--------|60| Table not visible | Check environment (dev/staging/prod) |61| MCP tools not showing | Run `claude mcp list` to verify connection |62| Social login not working | Check Provider settings in console |63| File upload fails | Verify size limits (image 10MB, video 100MB) |64| Slow queries | Add indexes via backend_index_manage |65| Data not syncing | Check x-environment header matches |6667## Official Documentation (Live Reference)6869For the latest cookbook and troubleshooting, use WebFetch:70- Cookbooks: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/cookbooks/blog/01-quick-start.md71- Troubleshooting: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/en/troubleshooting/01-common-errors.md72- Full TOC: https://raw.githubusercontent.com/popup-studio-ai/bkend-docs/main/SUMMARY.md7374---75> Converted and distributed by [TomeVault](https://tomevault.io/claim/popup-studio-ai) — claim your Tome and manage your conversions.76<!-- tomevault:4.0:skill_md:2026-04-11 -->