helloiamlukas/jigsaw-forestry-template

This package is abandoned and no longer maintained. No replacement package was suggested.

A Jigsaw template for Forestry.io

v1.1 2020-02-04 11:54 UTC

README

Simple Jigsaw website template for Forestry.io, with easy deployment on Netlify ⚡️

Features

This Jigsaw starter template comes pre-configured with:

  • Simple responsive website layout (preview)
  • Bootstrap 4.1.3
  • Vue 2.5.21
  • Sitemap Generator
  • Netlify deployment configuration

In addition it includes a Forestry.io configuration with the following features:

  • Easily add new pages 📝
  • Arrange items in the navigation bar ↕️
  • Basic css styling directly in the CMS 💅
  • Cloudinary media management 🌄
  • Live preview 🖥✨(powered by CircleCI docker image circleci/php:7.3-node)

Requirements

Installation

Jigsaw / Template

To use this starter template, create a new directory for your website:

mkdir cool-website

After that, navigate to your website folder and install Jigsaw:

cd cool-website
composer require tightenco/jigsaw

Now you can initialize the project with the template:

./vendor/bin/jigsaw init helloiamlukas/jigsaw-forestry-template

💡For further information, please take a look at the Jigsaw Documentation

Cloudinary Configuration

In order to make media uploads work properly, open the .forestry/settings.yml file and put in your cloudinary upload directory, as well as your cloud name.

For example:

upload_dir: cool-website-media
public_path: https://res.cloudinary.com/coolcloud/image/upload/w_1600,q_auto,c_limit

Deployment

For easy deployment, use Netlify. The template already includes a netlify.toml file with all necessary configuration. Just import your repository from the Dashboard and you're good to go 😎

Forestry.io Setup

After you have deployed your website, you can setup Forestry.io.

Login into your Forestry.io account and go to the Dashboard.

  1. Add a new site
  2. You will be asked, which static site generator you want to use. Choose Other (Gridsome, Next, Nuxt…)
  3. Next, choose your Git provider and select your repository.
  4. After the project has been imported, ignore the setup wizard.
  5. In the sidebar, go to Settings and select General » Deploy Admin to generate the CMS Backend.
  6. Now, you should be apple to access the CMS via https://your-site-name.netlify.com/manage/

Usage

For further information how to use Jigsaw, Forestry.io and/or Netlify, please refer to their documentation.

For questions regarding this project, please use the Issue section.