Recipes Web App — production-ready Crystal recipe manager starter

Recipes Web App is a production-grade recipe manager written in Crystal — generated by cenius.ai, Apache-2.0-licensed. A web application for managing recipes, built with Crystal and Lucky framework (or Kemal if Lucky's Postgres coupling is an issue), using SQLite for persistence. Clone Recipes Web App, run the installer, done — you have a working product in minutes. Want to change something? Open Recipes Web App on cenius.ai and say what you need — a revised build ships back, ready to deploy.

▶ Open & edit in cenius.ai — one click to an editable workspace: describe changes in plain English, get an instant preview, one-click deploy and host. Modifications made on the platform come with full rebrand & relicense rights.

Local clone? See Quick start below. cenius.ai is the zero-setup path.

Demo

▶ See it in action — full demo on the project page ·

Screenshots

Architecture

Open the repo and you'll find a complete Crystal application (241 files). Top-level layout: bin/, db/, lib/, public/, spec/, src/. install.sh wires up dependencies and loads seed records; after it runs the app has real data to show. Installation walkthrough: INSTALL.md.

Features

• Recipe list
• Create recipe
• Recipe detail
• Seed data

Quick start

./install.sh   # installs dependencies + seeds demo data

See INSTALL.md for full setup and usage instructions.

Usage guide

Starting the Server

In the project directory, run:

crystal run src

Alternatively, build the binary first and then execute it:

shards build
./bin/app

The server listens on http://0.0.0.0:3000 (or the port set in PORT).

Accessing the Application

Open a web browser and navigate to http://localhost:3000.

Recipe List (Home Page)

The root URL (/) displays all stored recipes. Click any recipe to view its details.

Add a Recipe

Go to http://localhost:3000/recipes/new. Fill out the form and submit it. The new recipe will appear in the list.

Recipe Detail

Each recipe in the list links to /recipes/:id where :id is the numeric identifier. This page shows the full recipe information.

Curl Examples

You can interact with the app via command line:

## Fetch the recipe list (HTML)
curl http://localhost:3000/

All other endpoints return HTML pages and are intended for browser usage.

Full guide: USAGE.md

FAQ

How do I run Recipes Web App on my own server?

It runs entirely on your own machine. Clone, run ./install.sh, and follow INSTALL.md — the whole stack is in this repo, no external dependencies required.

Can I use Recipes Web App in a commercial project?

Yes — it ships under the Apache-2.0 license, which permits commercial use, modification and redistribution. The full text is in LICENSE.

Is white-labeling Recipes Web App allowed?

Yes. The MIT license lets you remove the original branding and ship under your own name. For a guided approach, remix it on cenius.ai: you get a fresh build with full rebrand and relicense rights.

Is there a no-code way to modify Recipes Web App?

The easiest route: visit the project on cenius.ai, tell the platform what to change, and collect the updated build. No source-editing needed.

Which framework or language does Recipes Web App use?

Recipes Web App is a Crystal application — and this repository holds the complete, runnable source, not a stripped-down sample. Highlights include seed data.

License & rebranding

Released under the Apache License 2.0 (© 2026 Cenius AI) — free for personal and commercial use. The Cenius name/logo are trademarks (see NOTICE).

Need a customized version? Remix this app on cenius.ai — modifications made on the platform come with full rebrand & relicense rights over your derivative.

Built with cenius.ai

This entire application — code, design, seeded demo data — was generated on cenius.ai from a plain-English description.

• 🚀 Build your own app on cenius.ai
• 🎛️ Remix Recipes Web App on the marketplace — open it in a workspace, prompt for changes, and ship your own version.

More open-source apps: the Cenius-ai catalog · showcase index