Skip to content

Latest commit

 

History

History
82 lines (56 loc) · 2.83 KB

README.md

File metadata and controls

82 lines (56 loc) · 2.83 KB
Raw

Hack Your Future - Next.js + Contentful workshop

Welcome to the repo for this workshop!

What we will talk about:

  • What is a full-stack framework
  • Next.js
  • What are the different rendering strategies you can chose from (use cases and benefits):
    • Client Side Rendering (CSR)
    • Server Side Rendering (SSR)
    • Static Site Generation (SSG)
  • Client Components and Server Components
  • Brief intro to the concept of a CMS. We will specifically use Contentful for this project.

What you should do before the workshop:

  • Research Next.js default project structure (checkout the repo)
  • Go through the How to run the project and make sure to setup and run the app
  • Research App router:
    • What is file-based routing?
    • Creating a new page
    • Creating dynamic pages
    • Linking between pages
  • If you have never encountered Typescript yet, watch or read some brieft introduction to it

Don't worry if you don't have enough time to go through all of this content. We will do a quick refresher in the workshop.

The main focus of the workshop will be to introduce you to Next.js as a full-stack framework and focus on rendering strategies so you start grasping new and more advanced concepts that will help you in the future.

How to run the project

Initial actions:

  • fork the repository in GitHub
  • clone the repository locally from your GitHub account to your machine

  1. Create a .env.local file at the root level and add the following environment variables:
CONTENTFUL_SPACE_ID=<space id value>
CONTENTFUL_ENVIRONMENT=<environment value>
CONTENTFUL_ACCESS_TOKEN=<access token value>

The values for these variables will be provided in private through Slack. We are now a developer team and we don't post any secrets in public 😉

This setup connects you to an already created Contentful account, you just need to ask for the values. If you want to create and use your own Contentful account to fetch content from, follow the dedicated guide here.
Note that it is not required to have your own Contenful account (as you can utilize the already setup account) and it takes some effort to get it working, so evaluate your time and energy resources wisely.


  1. After having setup the .env.local file, install dependencies and run the project:
npm install
npm run dev

❗If you get an error like below, that is a setup issue on your side - you are not fetching any data. Consider why.


  1. Change "Blog." that is visible in the homepage to your name, take a screenshot of the homepage, and post it in the workshop Slack channel.
    Example:



Voilà! You are ready for the workshop! 💃🕺