Skip to content

jarenmcdonald1/rmdblog-nuxt

Repository files navigation

Rachel's Blog Site

Netlify Status

View live site here: rmdholistics.com

About the site

This is a business site meant to attract potential clients and existing customers to my services. I use the blog to post updates and stories that keep users coming back for more content!

Improvements

NuxtJS and Vue

Tools used to develop:

  • Adobe Illustrator, Photoshop, XD, Media Encoder
  • Nuxt.js
  • Vue 2
  • PostCSS
  • Tailwind
  • PurgeCSS
  • Dark mode & ColorModePicker
  • PWA
  • Netlify CMS
  • Prettier
  • Nuxt-content

Like what you see?

Developed by Jaren McDonald. Check out my portfolio for more jaren.ca Say hi! jaren.mcd@gmail.com

Get Started

  1. 📦 Install dependencies.
npm install
  1. 🏗 Run the project for local dev. This will start a hot-reloading server at localhost:3000.
npm run dev
  1. 🌌 Build the app for server-side rendered deployment. See more about Universal SSR in the Nuxt.js docs.
npm run build

# And to serve that deployment...
npm run start
  1. ⚡️ Generate a fully pre-rendered static site. See more in the docs.
npm run generate

Personalize setup

  1. Copy and change the .env-file

    • cp .env-example .env
    • Then change the values
  2. Change the value on these lines

    • static/admin/config.ymlsite_url & logo_url
    • content/site/info.jsonsitename, sitedescription & sitelang
    • package.jsonname, description, author & repository.url
    • pages/index.vue — The start page of your new website!
  3. Change colors, favicon, content & content collections

    • Colors are managed in assets/scss/_vars.scss & tailwind.config.js
    • Favicon is generated by @nuxt/pwa. You should change the static/icon.png to something new, and then match the new filename and source in nuxt.config.js under pwa.icon. Replace the preview.jpg as well.
    • Content is managed mainly in local Netlify CMS by going to your /admin, in development mode by double-clicking on a post or by hand in /content
    • Content collections are managed in static/admin/config.yml
  4. Change font

    1. Add/change your font link in nuxt.config.js under head.link. You can add a <link rel="stylesheet" href="font.css"> as link: [{ rel: 'stylesheet', href: 'font.css' }], like this
    2. Then append your font name in tailwind.config.js under theme.extend.fontFamily.sans (or other). Like sans: ['Inter', ...defaultTheme.fontFamily.sans]
    3. Then if you've uncommented the included netlify plugin "Subfont" in netlify.toml, it will automatically post-processes your web page to use an optimal font loading strategy.

More info

This project was bootstrapped with create-nuxt-app. There are more detailed explanations of how everything works in the Nuxt.js docs.

Netlify Identity

Make sure to set to "registration invite only" here if you don't want spam.

When you create your first account, don’t sign up using OAuth, generate a new password and sign in that way locally, otherwise a successful login will send you to the URL you typed in instead of keeping you on localhost.


Originally based on Henry Desroches' nuxt-netlify-cms-starter.


Troubleshooting

  • I added a CSS class, but it doesn't show

  • It is most likely purged by PurgeCSS, make sure it is whitelisted in purgeCSS in nuxt.config.js

  • I tried logging into/saving in Netlify CMS, but I can't

  • It may be that you haven't enabled Netlify Identity or setup the Git Gateway correctly, check the docs

  • "This repository is configured for Git LFS but 'git-lfs' was not found on your path."

  • Install git-lfs then run git lfs install in project root. Then to download the images, run git lfs pull. Or if you don't want to download the files/can't login to the lfs server, run git lfs install --skip-smudge instead.

  • I can’t get Git LFS to run correctly on Netlify

  • Make sure that you have in your Netlify build settings, set the environment variable GIT_LFS_ENABLED : true. Then also make sure that Netlify LM is setup as their docs specify.

About

RMD Holistic's public website. Built with NuxtJS and Netlify CMS

Topics

Resources

License

Stars

Watchers

Forks