Get started
A living guide
This is a living guide, running off your project Sass and JavaScript. It starts as the default, clean starter kit. It is not meant to be styled nicely.
As you write your project's Sass and JavaScript, this guide will pick up those changes.
You can delete this directory (/amplify
) if you don't need to refer to these docs or don't want to include it in your finished project.
- Grab an up-to-date copy of Amplify from GitHub
- Copy the following items from Amplify into your project (probably into the theme directory, but it will depend on your project setup):
/assets-src
directory.nvmrc
file - update to the current LTS versionpackage.json
andpackage-lock.json
filessvgo.config.js
filewebpack.config.js
file
- Check that the config
from
andto
paths inpackage.json
are correct for your project setup - Check the
context
andoutput
paths inwebpack.config.js
are correct for your project setup - Optional: copy the
/amplify
directory into the webroot - Follow the command line instructions to install project dependencies and check there are no errors when building the front-end assets
- Make sure the
html
element in your web page template has an appropriatelang
attribute and theno-js
class - Make sure your web page template includes the following (which can be copied from any of the example pages in the
/amplify
directory):- link to the core stylesheet
- link to the advanced stylesheet, including the media query to determine which browsers it will be served to
- link to the print stylesheet
script
for the Font Face Observer library in thehead
- another
script
in thehead
, which checks when the desired web font is loaded, adds thefonts-loaded
class tohtml
, adds the main JavaScript file to thehead
and switches theno-js
class tojs