Skip to content
The online space of The Hague Tech
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
api
components
helpers
offline
pages
static
.env
.gitignore
Procfile
README.md
app.js
package.json

README.md

thehaguetech-site

The website of The Hague Tech.

Project overview

The website is mostly written in JavaScript.

For frontend development we use NextJS, a React framework with native support for Server Side Rendering (SSR).

For backend development we use a simple express server.

Contributing

Do you have ideas or feedback? Or do you want to contribute to the design, content or code? You are very welcome to contribute!

Examples of contributions you could think of:

  • Bug reports
  • UI enhancements
  • General feedback
  • Textual updates
  • Improving this README

An easy way to start contributing is by creating a so called 'issue' with your feature request, idea or bug report. Start here.

Getting started

1. First time use

git clone git@github.com:bartwr/thehaguetech-site.git
cd thehaguetech-site
npm install

2. Running the app

  1. In .env, set Contentful API configuration. It should look something like this:
CONTENTFUL_SPACE_ID=YOURID
CONTENTFUL_ACCESS_TOKEN=YOURTOKEN
SENDGRID_API_KEY='SENDGRIDAPIKEY'
MAILCHIMP_ID='XXXX-us15'
  1. npm run dev

Need help? Create an issue.

3. gitmoji for git commits

Want to make use of gitmoji?

Using emojis on commit messages provides an easy way of identifying the purpose or intention of a commit with only looking at the emojis used.

Do the following:

npm i -g gitmoji-cli
gitmoji -i

From now, always git commit from your CLI. In example:

git add .
git commit

Hooray! Emoji intentions in front of your commit message.

Inspired by OpenBook.

4. Deploying the app

Heroku?

  • In settings tab, set config vars:
    • CONTENTFUL_ACCESS_TOKEN
    • CONTENTFUL_SPACE_ID
    • SENDGRID_API_KEY

Netlify?

  • Build command: npm run deploy
  • Publish directory: out

Running production on Windows?

SET CONTENTFUL_ACCESS_TOKEN=token
SET CONTENTFUL_SPACE_ID=id
SET SENDGRID_API_KEY=apikey
SET NODE_ENV=production
node api/server.js

Contributors

  • bartwr (Code)
  • Hans Pols (Graphic Design)
  • Peter Hofman (Server Management)
  • Charles Weiler-Ulin (Concept, Content)
  • Ali (Concept, Content)

NOTES on Design

  • 12px grid horizontally
  • 8px grid vertically (1rem - 8px)
You can’t perform that action at this time.