bkend-cookbook

bkend.ai project tutorials (todo to SaaS) and common error troubleshooting. Triggers: bkend tutorial, bkend cookbook, bkend troubleshooting

Jump to install

Repository: ww-w-ai/bkit-claude-code
Last source activity: August 9, 2026 at 05:24
Detected SKILL.md language: English
Stars: 594
Forks: 153

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/ww-w-ai/bkit-claude-code --skill bkend-cookbook

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

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:

Back to search Back to installation

qa-phase

QA Phase execution — L1-L5 test planning, generation, execution, and reporting for a single feature. For sprint-level QA (7-Layer dataFlowIntegrity / S1 gate across multiple features) use /sprint qa <sprintId> which delegates to sprint-qa-flow agent (v2.1.13). Triggers: qa phase, QA test, qa run

2026-08-17

cc-version-analysis

CC CLI version upgrade impact analysis — research changes, analyze bkit impact, generate report. Triggers: cc-version-analysis, CC upgrade, version analysis

2026-08-15

sprint

Sprint Management — generic sprint capability for ANY bkit user. 16 sub-actions: init, start, status, watch, phase, iterate, qa, report, archive, list, feature, pause, resume, fork, help, master-plan. Triggers: sprint, sprint start, sprint init, sprint status, sprint list, master plan, multi-sprint plan, sprint master plan

2026-08-15

View all from this repository

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:

bkend-cookbook

Source facts

Install options

Review the source files

bkend.ai Cookbook & Troubleshooting

Single Project Guides

Full Guide Projects (4, each with quick-start + 7 chapters)

Common Implementation Pattern

Troubleshooting Quick Reference

FAQ

Official Documentation (Live Reference)

More from this repository

bkend.ai Cookbook & Troubleshooting

Single Project Guides

Full Guide Projects (4, each with quick-start + 7 chapters)

Common Implementation Pattern

Troubleshooting Quick Reference

FAQ

Official Documentation (Live Reference)

More from this repository