Giter Club home page Giter Club logo

recipes's Introduction

My Online Cookbook logo

My Online Cookbook

My Online Cookbook is a starter kit to create your own website of recipes, using Eleventy and Netlify CMS. It is meant to be both highly accessible (including to non-developers), as well as fully customisable should you want to use it as a starting off point.

Presentation & set-up instructions : https://myonlinecookbook.xyz/

Demo (this is what you get out of the box) : https://myonlinecookbook.netlify.app/

Get started now by forking the project or deploy to Netlify : Deploy to Netlify

Features

๐Ÿ“˜ Optimised for recipes

Unlike other general-purpose templates and website builders, My Online Cookbook is optimised for writing, reading and easily finding back your recipes. Quickly visualise which ingredients you need, navigate between recipes in the same categories, and automatically adapt quantities based on the number of servings.

๐Ÿ’ช Powerful search

The kit includes a powerful live search system offering a UX on-par with third-party services like Algolia, without needing any external dependency or subscription service.

๐Ÿงฐ Lightweight & easily extendable

Easily customise the theme color and other site attributes using the global data files, or dive into the code and change anything. The CSS is authored using Sass and following the BEM naming convention. JavaScript is added where needed using Alpine and following a component-based approach. Images are processed and optimised at build-time using the Eleventy image plugin. Apart from Alpine, there are no run-time dependencies, making the site both extremely lightweight and easy to pick up and modify.

Running the site locally

  1. npm install to install all dependencies
  2. npm run dev to serve the site locally
  3. npm run build to build the site for production

Access the CMS admin interface

Go to /admin to access the admin interface (this also works locally). You'll need to configure a user with Netlify Identity to log in. For more information on how to use or configure Netlify CMS go to their documentation. In addition to recipes, all site settings (primary color, etc) as well as labels are editable from this interface.

Directory structure

  • .eleventy.js has all the custom configuration for Eleventy, including collections, filters and shortcodes.
  • src/_data contains nav and site settings, also editable from the CMS admin interface.
  • src/_includes contains layouts and reusable components (including SVG icons).
  • src/admin contains the configuration for editable fields in Netlify CMS.
  • src/img contains all images. Note that only images placed in src/img/recipes are editable from the CMS admin interface.
  • src/recipes is your main content, with each recipe saved as a markdown file.
  • Each other page is located at the root of src/ as its own markdown or nunjucks file.

recipes's People

Contributors

maeligg avatar beneverard avatar

Watchers

 avatar James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.