Offline Recipe Box

Project roadmap

1. 01

   Plan the screens and data

   ~1h

   Write README.md describing the screens (recipe list with search, recipe detail, add and edit form, import from link) and the data: a recipe has a title, servings, prep minutes, a list of ingredients (each with a name and amount) and steps. Write an example of the JSON format that can be imported, and host it somewhere, such as a GitHub Gist. Done when: README.md shows the screens and an example JSON recipe.

2. 02

   Create the SwiftData model

   ~1.5h

   Create a SwiftUI app with SwiftData models Recipe and Ingredient, with a relationship that deletes a recipe's ingredients when it's deleted. Check values when saving: the title can't be empty, servings are between 1 and 50, and prep minutes aren't negative. Add sample recipes for previews. Done when: recipes with ingredients can be created in code and are still there after restarting.

3. 03

   Build the list, detail and form

   ~2h

   Show recipes with @Query in a list, sorted by title. Tapping opens a detail screen with ingredients and numbered steps. Add a form for creating and editing recipes, including adding and removing ingredients, and swipe to delete in the list. Done when: recipes can be created, viewed, edited and deleted.

4. 04

   Search recipes

   ~1h

   Add a search field with .searchable that matches recipe titles and ingredient names, ignoring upper and lower case. Show a message when nothing matches. Done when: searching for an ingredient such as garlic shows every recipe that uses it.

5. 05

   Import from a link

   ~1.5h

   Add an Import screen where the user pastes a link. Download it with URLSession, decode the JSON with Codable, validate it like a normal recipe, and save it with SwiftData. Show clear messages when offline, when the link isn't valid, or when the JSON is in the wrong format. Done when: importing your hosted example recipe works, and it opens later in airplane mode.

6. 06

   Test it

   ~1.5h

   Write unit tests with an in-memory SwiftData container: validation rules, searching by title and ingredient, deleting a recipe removes its ingredients, and decoding valid and broken JSON. Test by hand in airplane mode. Done when: the tests pass, and everything except importing works offline.

Resources

• DocsSwiftData documentation
• DocsSwiftUI tutorials (Apple)
• DocsAdding a search interface to your app (searchable)
• DocsFetching website data into memory (URLSession)