Full name: Not Just The Acronym
Current/old website: www.example.com
Description: A little description about the client/project
Designs: www.figma.com/abc
Sitemap: www.figma.com/file/4nN9qgqFVHYqlabovASf8E/Sitemap-Template (< to duplicate + adjust for current project)
It's highly suggested that you read through the Next and Prismic documentation below before starting
UA5 has also put together a playlist of videos that provide a bird's eye view our toolset.
If you have not yet connected this codebase to Prismic carefully read through the instructions here. Otherwise, you can probably skip those instructions and simply read the following to get the project up and running locally:
Get a copy of the .env.local file from a UA5 colleague and add the file to the project root. Make sure that file is sent and received securely since this document will contain sensitive information that needs to remain hidden.
You may run into issues if you're using a different node version than the one specified in the .nvmrc file. For this reason, it is recommended that you install that version with nvm (node version manager).
nvm use
This project uses the yarn package manager. To begin development, run the following commands, which will install dependencies and run the development server.
yarn
yarn devYour site should be up and running on http://localhost:3000!
The CMS for this site is hosted on Prismic.
The components directory is where you'll be creating the component templates that form your site. The directory is broken up into four subdirectories:
- Layout. Here you will add global components which make up the layout of your site across all pages. The navigation, footer, grid, and any other component which could be considered "global" go here.
- Pieces. Repeatable pieces of the site that can be found across multiple components, such as a button or link. OR, a chunk of another component broken down, such as slideshow arrows or video overlay.
- Slices. These should correspond directly with your prismic slices.
- Templates. These will be called by whatever routes you've created under
pages. So here you might have your base page template, plus a blog post template.
This project has been configured w/ Storybook. While developing your components, run yarn storybook to start Storybook locally. Each of your components should come with a stories.js file, which will automatically add the component to Storybook. As part of the development process, developers should be creating stories in order to test your component in different viewports and edge-case scenarios having to do with different properties passed or not passeded to your component.
This site is hosted on vercel. The master branch is associated with production. When master is pushed, the latest code will deploy to production automatically. For this reason, do not work directly off of the master branch. Only merge your code into master when you are ready to take the changes live.