/mig

:zap: A curated list of awesome tools and projects created by Ghanaians

Primary LanguageJavaScript

Made In Ghana (Static Site Generator)

This is a static site generator, built with Next.js, for the Made In Ghana repository showcasing made in Ghana repositories.

Architecture

This site is setup with the JAMStack philosophy.

  • The static site generator, hosted on Netlify, receives a webhook event whenever a new project is added via merge.
  • This kicks off the build process which pulls in the readme from the Made In Ghana repository, parses it into JSON and renders static HTML page(s) using Next.js
  • Static HTML files, in the out diretory,are in turn uploaded to the Netlify CDN ready to be viewed by the world.

alt text

File structure

├── components Compnents used in the various pages
├── lib Utility libraries
├── pages Main pages, index, about etc
└── static Static assets. images, css, fonts etc

Setup

  • Clone/Fork repo
  • Run npm install
  • Run npm run dev to start development server on port 3000
  • Run npm run build to run as a server side rendered app in production
  • Run npm run build:static to build site as static files into the out directory. This file can be uploaded to any CDN or web server of your choice.

Resources