TacoFancy

About TacoFancy

TacoFancy API provides random taco recipe data through a REST API. It sources content from the dansinker/tacofancy recipe collection and structures recipes into base layers, mixins, condiments, seasonings, and shells.

The API exposes endpoints for retrieving a random recipe component or a full random taco (base layer, mixin, condiment, seasoning, and shell combined). It also provides endpoints for looking up contributors to a specific recipe, listing all recipe slugs for a given layer type, and viewing all contributions made by a specific GitHub username.

The project is intended for developers who want to run or extend the API themselves: it includes a Docker-based setup (via a Makefile with commands to start the app, initialize the database, and load data), a local development mode, and a test suite. Configuration is handled through environment variables for the database connection string and an optional GitHub token for higher API rate limits. The repository is released under the MIT license.

Key features

• Returns a random taco recipe with base layer, mixin, condiment, seasoning, and shell
• Full random taco recipe endpoint via /random/?full-taco=true
• Lists contributors for a specific recipe via /contributors/:recipe_type/:recipe_slug/
• Lists all contributions by a given GitHub username via /contributions/:github_username/
• Dockerized setup with Makefile commands for running and initializing the database

Frequently asked questions