joncoded / jonohash

site starter kit with hashnode's graphQL public api

jonohash

this is a fork of hashnode's starter kit

the main modifications happen at this folder level

setup simplified

this procedure assumes that:

• you already have a hashnode account and blog
• you already have a vercel account to host the front-end
• you know how to use the command-line terminal on your computer

vercel

• fork this repo
• add a new project on vercel
• connect the forked repo (jonohash)
• choose the following for the "root directory"
  • starter-kit
    • packages
      • blog-starter-kit
        • themes
          • jonohash
• set the environment variables

NEXT_PUBLIC_HASHNODE_GQL_ENDPOINT=https://gql.hashnode.com
NEXT_PUBLIC_HASHNODE_PUBLICATION_HOST=yoursite.hashnode.com
NEXT_PUBLIC_MODE=production
NEXT_PUBLIC_BASE_URL=/blog -> remove this line if just installing on root

• let it deploy!

local machine

• go to an empty folder
• clone this repo
  • git clone https://github.com/joncoded/jonohash.git .
• move into that folder and then
  • cd packages/blog-start-kit/themes/jonohash
• on that same folder, copy the NEXT_PUBLIC... environment variables in env.example to .env.local
• modify the values in .env.local
• if not already
  • npm install pnpm -g
  • (may have to use sudo npm install pnpm -g depending on settings)
• then of course
  • pnpm install
• and finally
  • pnpm dev
• go to http://localhost:3000

re-deployment

• commit and push all new code: git push origin main
• vercel will automatically re-deploy on the vercel URL!