KitchenPC Samples

Example applications that demonstrate how to build on the KitchenPC recipe engine.

Requirements

• .NET 10 SDK

Restore and build every sample from the repository root:

dotnet restore Samples.slnx
dotnet build Samples.slnx --configuration Release --no-restore

Included samples

Shopping List TUI

A database-free Terminal.Gui application that initializes StaticContext from the bundled sample data, parses natural-language shopping items, aggregates compatible quantities, and persists the list in the current user's local application-data directory.

See Console/README.md for details.

React Web App

A modern ASP.NET Core, React, and TypeScript recipe site. It browses and searches the PostgreSQL sample recipes, displays full recipe details, and builds an aggregated shopping list from recipes and natural-language additions. It also demonstrates the parsing-only DBContext profile.

See WebApp/README.md for setup instructions.

Database Initializer

A command-line provisioning tool that creates the KitchenPC schema in a PostgreSQL database and imports the bundled static sample data. It provides a repeatable local database for the React web sample.

See DatabaseInitializer/README.md for Docker, PostgreSQL, and provisioning instructions.

Sample data

SampleData/KPCData.xml is a small static snapshot containing ingredients, forms, NLP data, and a limited collection of recipes. It is intended for examples and local experimentation; it is not a replacement for a fully provisioned KitchenPC database.