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:
