Skip to main content

Documentation

Browse documentation

cubby helps you organize recipes, track ingredients, manage inventory, and keep everything in its place.

Core Concepts

cubby is built around five key entity types that work together:

Ingredients
The building blocks of recipes. Generic items like "flour" or "butter" that appear across multiple recipes.
Products
Specific purchasable items linked to ingredients. Products can have unit mappings, UPC barcodes, and optional USDA nutrition data.
Locations
Hierarchical storage areas (Kitchen → Pantry → Top Shelf). Supports types like room, shelf, drawer, and CSV import/export with parent references.
Recipes
Collections of ingredients with amounts, organized into sections with step-by-step instructions.
Inventory
Tracks what products you have and where. Links products to locations with quantities.
Entity Relationships
Generated Cubby entity relationshipsSOURCERELATION · CARDINALITY · PROVENANCETARGETProductClassification · one · categoryProduct CategoryProductIngredient · one · ingredientIngredientProductGrows plant · one · grows-plantPlantProductPlantings · many · plantingsPlantingProductUsed on projects · many · project-usesProjectProductVendors · many · vendorsVendorProductProjects · many · purchased-projectsProjectProductPurchases · many · expense + explicitPurchaseProductExpenses · many · expensesExpenseProductInventory · many · inventoryInventory ItemProductTasks · many · tasksTaskProductEaten at meals · many · mealsMealProductEaten by · many · eatersLedger PartyProductWishlist candidates · many · wishesWishProductServing as locations · many · locationsLocationProductImages · many · imagesImageProductComponents · many · explicitProductProductContaining kits · many · explicitProductProductUSDA food · one · usda-foodUSDA FoodProductDevices · many · devicesDeviceRecipeCookbook · one · cookbookCookbookRecipeForked from · one · forkedFromRecipeRecipeImages · many · imagesImageRecipeIngredients · many · ingredientsIngredientRecipeSub-recipes · many · sub-recipesRecipeRecipeMeals · many · meals + served-portionsMealIngredientProducts · many · productsProductIngredientPlants · many · plantsPlantIngredientRecipes · many · recipesRecipeIngredientRecipe · one · recipeRecipeIngredientEaten at meals · many · mealsMealIngredientEaten by · many · eatersLedger PartyCookbookRecipes · many · recipesRecipeCookbookCover image · one · coverImageCookbookProduct · one · productProductLocationSub-locations · many · childrenLocationLocationInventory · many · inventoryInventory ItemLocationParent location · one · parentLocationLocationProduct · one · productProductLocationIngredients · many · ingredientsIngredientLocationImages · many · imagesImageLocationPlantings · many · plantingsPlantingLocationGarden entries · many · garden-entriesGarden EntryInventory ItemProduct · one · productProductInventory ItemLocation · one · locationLocationInventory ItemOwner · one · ownerLedger PartyInventory ItemIngredient · one · ingredientIngredientMealRecipes · many · recipes + served-portionsRecipeMealFood products · many · food-productsProductMealFood ingredients · many · food-ingredientsIngredientMealEaters · many · food-entries + portionsLedger PartyMealImages · many · imagesImageLedger PartyAttributed expenses · many · expensesExpenseLedger PartyFinancial accounts · many · financial-accountsFinancial AccountLedger PartyOutgoing transfers · many · outgoing-transfersLedger TransferLedger PartyIncoming transfers · many · incoming-transfersLedger TransferLedger PartyMeals eaten · many · food-entries + portionsMealLedger PartyRecipes eaten · many · recipes-eatenRecipeLedger PartyInventory · many · inventoryInventory ItemLedger PartyImages · many · imagesImageLedger PartyVendor accounts · many · vendor-accountsVendor AccountLedger PartyRuns · many · runsRunLedger PartyDevices · many · devicesDeviceLedger TransferFrom party · one · from-partyLedger PartyLedger TransferTo party · one · to-partyLedger PartyLedger TransferEvidence transactions · many · evidence-transactionsFinancial TransactionProjectSub-projects · many · sub-projectsProjectProjectPurchases · many · purchasesPurchaseProjectParent project · one · parentProjectProjectBlocked by · many · blocked-byProjectProjectReusable resources · many · explicitProductProjectPurchases using this default · many · defaultPurchasesPurchaseProjectTasks · many · tasksTaskProjectExpenses · many · expensesExpenseProjectTask products · many · task-productsProductProjectPurchased products · many · purchased-productsProductProjectVendors · many · vendorsVendorProjectImages · many · imagesImageTaskSubtasks · many · subtasksTaskTaskProject · one · projectProjectTaskSubject product · one · subjectProductTaskParent task · one · parentTaskTaskBlocked by · many · blocked-byTaskTaskImages · many · imagesImageTaskPlantings · many · plantingsPlantingVendorLogo image · one · logoImageVendorRecent expenses · many · expensesExpenseVendorPurchases · many · purchasesPurchaseVendorProducts · many · productsProductVendorProjects · many · projectsProjectVendorFinancial transactions · many · transactionsFinancial TransactionVendorAccounts · many · accountsFinancial AccountVendorVendor accounts · many · vendor-accountsVendor AccountVendorRuns · many · runsRunPurchaseSpending category · one · spendingCategorySpending CategoryPurchaseVendor · one · vendorVendorPurchaseVendor account · one · vendor-accountVendor AccountPurchaseImages · many · imagesImagePurchaseFinancial transactions · many · financial-transactionsFinancial TransactionPurchaseExpenses · many · expensesExpensePurchaseProducts · many · expense + explicitProductPurchaseDefault project · one · defaultProjectProjectPurchaseProjects · many · projectsProjectFinancial AccountStored-value provider · one · provider-vendorVendorFinancial AccountLedger party · one · ledger-partyLedger PartyFinancial AccountTransactions · many · transactionsFinancial TransactionFinancial AccountPurchases · many · purchasesPurchaseFinancial AccountVendors · many · vendorsVendorFinancial TransactionSpending category · one · spendingCategorySpending CategoryFinancial TransactionFinancial account · one · accountFinancial AccountFinancial TransactionLedger transfer · one · ledger-transferLedger TransferFinancial TransactionPurchase · many · purchasePurchaseFinancial TransactionVendor · many · vendorVendorFinancial TransactionExpenses · many · expensesExpenseFinancial TransactionProducts · many · productsProductWishCandidate products · many · candidatesProductExpenseCategory override · one · spendingCategorySpending CategoryExpensePurchase · one · purchasePurchaseExpenseProject · one · projectProjectExpenseProduct · one · productProductExpensePurchase transactions · many · transactionsFinancial TransactionImageCaptured by · one · captured-byLedger PartyPlantingPlant · one · plantPlantPlantingSource product · one · source-productProductPlantingCurrent location · one · locationLocationPlantingTask · one · taskTaskPlantingJournal entries · many · entriesGarden EntryGarden EntryLocation · one · locationLocationGarden EntryPlantings · many · plantingsPlantingGarden EntryImages · many · imagesImageVendor AccountVendor · one · vendorVendorVendor AccountMember · one · ledger-partyLedger PartyVendor AccountPurchases · many · purchasesPurchaseVendor AccountRuns · many · runsRunProduct CategoryParent category · one · parentProduct CategoryProduct CategoryProducts · many · productsProductProduct CategorySubcategories · many · childrenProduct CategoryRunVendor account · one · vendor-accountVendor AccountRunVendor · one · vendorVendorRunMember · one · ledger-partyLedger PartyRunPredecessor · one · predecessorRunRunPurchases · many · purchasesPurchaseDeviceOwner · one · ownerLedger PartyDeviceHardware · one · hardwareProductPlantIngredient · one · ingredientIngredientPlantPlantings · many · plantingsPlantingPlantSeeds and plants · many · productsProductSpending CategoryParent category · one · parentSpending CategorySpending CategorySubcategories · many · childrenSpending CategorySpending CategoryPurchases · many · purchasesPurchaseSpending CategoryExpense overrides · many · expensesExpenseSpending CategoryTransactions · many · transactionsFinancial Transaction