ziishaned / nextjs-apollo-ts-starter

Next.js Apollo TypeScript pre-configured starter with great DX

Next.js Apollo TypeScript Starter With Docker

What you get

Features

• Latest Next.js version.
• GraphQL Apollo client with built-in JWT authentication.
• Localization via i18next.
• Configured TypeScript environment.
• Configured Sass/SCSS via next-sass for styling (plus Normalize.css included).
• Built-in helpers.

Developer Experience

• Testing environment via Jest and @testing-library/react.
• Prettier for code formatting.
• Debug configuration for VSCode.
• Docker configuration to serve production-ready build with Nginx.

Getting started

Start development server

yarn
yarn start

Run tests

Run tests located in __tests__ directory:

yarn test

---

Pretty much everything you need to know you can find in Next.js documentation.

Additional Helpers

useAuth() Hook

This hook helps you to implement authentication. Here is an example how to use it:

import React from 'react';

import { useAuth } from './utils/auth';

const MyPage = () => {
  const [{ data }, logout] = useAuth();

  const handleLogout = () => {
    logout(); // Removes token from cookies
    document.location.reload();
  };

  return (
    <div>
      {data ? (
        <div>
          <div>Hello, {data.me.name}!</div>
          <button onClick={handleClick}>Log out</button>
        </div>
      ) : (
        <div>Please sign in</div>
      )}
    </div>
  );
};

Docker

Build and run Dockerized production-ready build, run:

docker-compose up --build