What are we going to build? During this lesson, you'll get to know more about the course, the tech stack, and what you're going to learn.

Course Introduction

Introduction

In this lesson, we'll cover the basics of GraphQL; what it is and how to use it. We'll also understand how it fits the course's subject.

Introduction to GraphQL

We'll learn about Hasura and play a bit with its features and writing GraphQL queries. This knowledge will let us move on to the commenting system!

Using Hasura to Generate GraphQL APIs and Protect Data

In this lesson, we'll create a comments table and learn a bit about databases along the way.

How to Create a Comments Database Table and Set Permissions

Storing comments with Hasura

We'll get to know a sample blog application that we'll be adding a comments section to. We'll also go over the setup and explain the directory structure.

Setting Up Next.js Blog Starter and Understanding Its Structure

In this lesson, we'll create a React hook that will fetch the comments from the database. We'll cover how to create a custom hook as well as how to integrate with Hasura.

Fetching Blog Comments from a Database with a Custom React Hook

In this lesson, we'll add a UI for the comments section and a new comment form. We'll also display the comments that we get from the React hook.

A Brief Tutorial on Building the UI for a Blog Comments Section

This lesson will show how to extend the hook to handle adding new comment logic. It will cover adding a new GraphQL mutation and using it from the frontend application.

How to Use GraphQL to Add Comment Features to a Frontend App

Implementing a comments system

We'll learn about optimistic updates and add them to our hook's implementation to improve the user experience.

An Overview of Optimistic Updates for React Hooks

In this lesson, we'll add pagination to both the hook and UI.

Adding Pagination to a Comments Section with Hasura and React

Extending the comments system functionality

This lesson will teach you how to publish a React hook as an NPM library.

How to Publish a Custom React Hook as an NPM Library

Right now, all the comments are public instantly. However, we may want to review the comments before showing them to other users. This is what we'll cover in this lesson.

Coding a Comments Section that Requires Manual Content Approval

Bonus

We just completed the course! Let's see what's next and how you can use the new knowledge.

Summary

react

next.js

### The newline Guide to Full Stack Comments with Hasura and React

Build and implement a comprehensive commenting system for your website using Hasura and React.  We’ll use the commenting feature to teach technology concepts like Hasura with appropriate authorization, optimistic updates for a more responsive UI, pagination, and publication of library in NPM.

### Why this course

Many developers would like to add a comments section to their website or blog for users to post comments or hold discussions. While it's possible to use existing hosted solutions such as Disqus or Facebook Comments, they often charge a fee and impose their UI leaving little to no control for modifications or customization. 

Another option is to build your own from scratch — which is what we'll do in this course. We’ll use Hasura, which generates GraphQL API from a database so that the backend part is as easy and the least time-consuming as possible. Along the way, we’re going to learn about databases, GraphQL, building UI components with React and TypeScript, and more.
By the end of this course, you’ll have a commenting system added to a website we’ve called, Why comments?, with all comments stored by Hasura. We'll also publish the fetching and adding comments logic as a library to NPM.

This course focuses on building a commenting widget, however, the skills you’ll acquire will allow you to build any fullstack widget you can think up for your application.  You’ll be able to contribute to fullstack React, GraphQL, and Hasura projects at work, in open source, or your own projects. You'll discover that this stack not only eliminates the need for having large teams of backend developers, but it lets your projects move faster.

### Your Instructors

Hi, I'm Aleksandra, and I'm your instructor for this course. I’m the former tech lead of Hasura console and lead maintainer of Bliz.js. This course combines my knowledge in a few areas such as TypeScript, React, Hasura, GraphQL, and general application development.

Build and implement a comprehensive commenting system for your website using Hasura and React.  We’ll use the commenting feature to teach technology concepts like Hasura with appropriate authorization, optimistic updates for a more responsive UI, pagination, and publication of library in NPM.

The newline Guide to Full Stack Comments with Hasura and React

Implementing pagination and optimistic updates

Importance of tests, and how to test React components

In the previous modules, we added a commenting system to a sample blog
application. But what if we want to add comments to multiple applications? We
could need to copy-paste the hook to different projects. However, we can also
publish the hook as an NPM library and import it into any project. That is what
we'll do in this lesson, and it's going to take just a few steps!

To deploy our hook as an NPM package, we need to use a bundler.

 is a tool that bundles JavaScript or TypeScript modules
into a single JavaScript file that can be executed in the browser.

zero-configuration bundler for tiny modules

. It comes with
TypeScript support out of the box, and it's pretty straightforward to set up.

We can install it with the following command:

Before we use it, let's fill a few things in the 

Since we're publishing the package from the same place where we have the blog
application, we will add a separate tsconfig specifically for the library.

 that will compile the
source code to the 

"build:microbundle": "microbundle --no-compress --tsconfig tsconfig.lib.json"

Now, we can try and run it with the following command:

---
title: How to Publish a Custom React Hook as an NPM Library
isPublicLesson: false
description: This lesson will teach you how to publish a React hook as an NPM library.
useMdx: true
privateVideoUrl: https://fullstack.wistia.com/medias/3u0he7970d
---

In the previous modules, we added a commenting system to a sample blog
application. But what if we want to add comments to multiple applications? We
could need to copy-paste the hook to different projects. However, we can also
publish the hook as an NPM library and import it into any project. That is what
we'll do in this lesson, and it's going to take just a few steps!

### Bundling

To deploy our hook as an NPM package, we need to use a bundler.

> A **module bundler** is a tool that bundles JavaScript or TypeScript modules
> into a single JavaScript file that can be executed in the browser.

We're going to use [Microbundle](https://github.com/developit/microbundle),
which is a _zero-configuration bundler for tiny modules_. It comes with
TypeScript support out of the box, and it's pretty straightforward to set up.

We can install it with the following command:

    yarn add -D microbundle

Before we use it, let's fill a few things in the `package.json`:

-   `"name": "@anemone/newline-use-comments"` — the package name. I'm prefixing it
    with my NPM username `@anemone`.
-   `"source": "lib/useComments.ts"` — the source code.
-   `"main": "dist/index.js"` — the location where Microbundle should generate the
    CommonJS bundle.
-   `"types": "dist/useComments.d.ts"` — TypeScript types location. Microbundle
    will generate types from our module and put them there.
-   `"module": "dist/index.esm.js"` — the location where the
    [ESM](https://nodejs.org/api/esm.html) bundle should be placed
-   `"files": [ "dist" ]` — files that should be included in the package. We want
    to ignore all the blog application code.
-   `"version": "0.0.1"` — the version of our package. Feel free to set a
    different number.
-   `"private": false` — otherwise we won't be able to publish the library.