Browse documentation

๐Ÿงญ Start Here

Blackcap Overview โœจ Blackcap Feature Catalog ๐Ÿค– AI Features ๐Ÿงฑ Technology, Administration, and Reliability Installation First Run

๐Ÿ“˜ User Guides

Administration and Operations Platform Configuration Organization Configuration Email and Consent Management

๐Ÿš€ Deploy Blackcap

Platform Stacks and Raspberry Pi Hardware Raspberry Pi Deployment Raspberry Pi Client Services GCP Deployment Packaged Blackcap deployment Application Updates After Your First Blackcap Login: Self-Hosted Setup Guide Blackcap Release Notes Environment Variables and Secrets Reverse Proxy and TLS Background Jobs and Schedules

๐Ÿ› ๏ธ Administer Blackcap

Organizations Users, Permissions, and Authentication Configuration Workspace Backups and Restore Database Administration Regression Testing Performance and Job Status Audit, Access Activity, and Logging GeoIP and Access Location Data Retention and Purge Support Chat Administration Support Requests API Tester and Postman Instance Reporting Third-Party Packages and Attribution AI Provider Usage and Billing Portals Microwave Pie licensing for Blackcap Microwave Pie licensing for Blackcap

๐Ÿฝ๏ธ Use Recipes

Recipes and the Recipe Library Recipe Import and Discovery Recipe Editing and Cache Artifacts Recipe Sharing Social Recipe Import AI Recipe Image Generation ๐Ÿช„ Adapt Recipe and ๐ŸŽฒ Variations

๐Ÿ“… Plan Meals

Meal Planner

๐Ÿ›’ Use Shopping Lists

Shopping Lists and Shop a List External and Household Shopping ๐Ÿ”— Chrome Extension Shop With

๐Ÿงบ Manage Kitchen Inventory

๐Ÿงบ Kitchen Inventory

๐Ÿ–ฅ๏ธ Use Displays

Displays and Connections Assigning and Scheduling Display Content Remote Pi Client E-Ink Rendering Menu Refresh and Rendering Noun Project Footer Images

๐Ÿง‘โ€๐Ÿณ Cook with Letโ€™s Cook

๐Ÿง‘โ€๐Ÿณ Letโ€™s Cook ๐Ÿง‘โ€๐Ÿณ Letโ€™s Cook Controls and Timers

๐Ÿค– Use and Administer AI

๐Ÿค– AI in Blackcap ๐Ÿค– AI Providers and Connections ๐Ÿค– AI Seeds and Usage Support Chat

๐Ÿ”— Use the Chrome Extension

๐Ÿ”— Blackcap Chrome Extension ๐Ÿ”— Chrome Extension Recipe Capture ๐Ÿ”— Chrome Extension Shop With ๐Ÿ”— Chrome Extension Release and Privacy

๐ŸŽฎ Play Games

Games and trivia Bramble Harvest โ€” Player Guide Flavor Lab โ€” Player Guide

๐Ÿ”Œ Integrations

Email Integration Cloud Storage Integrations Voice Assistants Shop With Integrations Authentication Providers

โš™๏ธ Develop Blackcap

Application Architecture Database Service and Data Access SQLite and PostgreSQL Database Migrations Background Job Architecture Testing Games platform โ€” current developer reference Bramble Harvest developer tools API Architecture Security and Organization Scoping UI, Icons, and Documentation Assets Blackcap-Safe Emoji Support Chat Architecture Extending Support Chat Support Chat Model Benchmark Documentation Standards Terminology

โš ๏ธ Troubleshoot Blackcap

โš ๏ธ Troubleshooting Licensing Troubleshooting Deployment Troubleshooting Display Troubleshooting Recipe Import Troubleshooting ๐Ÿค– AI Troubleshooting Backup Troubleshooting Database Troubleshooting Diagnostic Organization Clones Support Chat

Bramble Harvest developer tools

Audience: Developers and testers. For player instructions, use the current Bramble Harvest guide.

Bramble Harvest includes read-only visual inspection tools for checking artwork, seasonal visitors, and character animations. In Blackcap โ†’ Games, open your browser's developer console and enter bh() to see the registered tools. The primer preview works directly from Games, without opening a garden; other tools may require an active garden.

Command What it opens
bh() Developer tool launcher and help
bh('list') Registered tools in the console
bh('holidays') Holiday visitor animation tour
bh('cappy') Cappy clothing and animation inspector
bh('beds') Crop/bed state visual inspector
bh('primer') Review the current first-time introduction; Previous/Next previews all four difficulty levels
bh('close') Close the tool launcher

Useful examples:

bh('holidays', { country: 'US', year: 2027 });
bh('cappy', { pose: 'water', frameMode: true, masks: true });
bh('beds', { crop: 'kale', stage: 2, protection: 'cover', watered: true });
bh('primer'); // Opens the real primer, even without an open garden
bh('primer', { difficulty: 'hard' }); // Start the preview at Hard

The bed inspector previews crop growth, protection, moisture, weeds, pests, fertilizer, and plant condition using the game's real renderer, without modifying a garden. The Cappy inspector previews equipped or selected outfits, poses, and frames without purchasing or saving clothing. The holiday tour displays scheduled seasonal artwork. The launcher's registration and styling live in inky_admin/static/js/bramble_developer_tools.js and inky_admin/static/css/bramble_developer_tools.css.

Tests and diagnostics live under tests/; baseline JSON fixtures for original Cappy artwork are in tests/fixtures/bramble/. The audit tool python tools/audit_original_cappy_clothing.py writes its optional report to tests/reports/, not to player documentation.

The primer tour reuses the live onboarding dialog and lets you move through Basic, Easy, Medium, and Hard with compact Previous/Next controls. It works from the Games menu without a garden. Exit returns to the view where you opened it. It never creates a garden, alters its difficulty, or changes the saved first-entry flag. Full guide opens the existing in-game Guide if a garden is active, or the Bramble Harvest documentation page in a new browser tab if no garden is open.