Course Introduction

Environment Setup With nvm

Scaffolding a React Hook Library with npm init

Building a Skeleton create-react-app to Test the Hook

Building Title Looping Functionality with the useEffect Hook

Packaging react-use-please-stay as an npm Module using Rollup

Cleaning Up and Refactoring react-use-please-stay

In this module, you'll focus on scaffolding all the tooling, building, and an example app to test your hook.

Building the First Functionalities of the react-use-please-stay Hook

Implementing a Cascading Letter Functionality

Implementing a Marquee Functionality

Implementing Favicon Modification Functionality

Add Interval Time as a Hook Parameter

Add Should Always Play as a Hook Parameter

In this module, you'll build more complex functionalities like changing the document title in advanced ways and even altering the favicon.

Adding Advanced Functionalities to react-use-please-stay

Use Custom Types to Type the Hook Parameters

Adding a Development-only Warning Logger

Prevent Concurrent Usages of the Hook

Restore Original Values on Refocus and Unmount

Publish the Hook to npm

In this module, you'll go through some optimizations and improvements to make a truly state-of-the-art React Hook package, and publish it to npm.

Finishing Touches and Optimizations

Prepare the Example App as a Public Example Page

Publish the Example App to GitHub Pages

In this module, you'll publish the example app to double as a live example of the hook running, as well as a complete documentation site.

Finalizing and Publishing the Example App

In **Master Custom React Hooks with TypeScript**, you will learn everything you need to start — completely from scratch — to publishing a fully-fledged React Hook built with Typescript, including a variety of complex features, detailed documentation, and a fully interactive example site. The course spans **4 modules** with a total of **19 lessons** and **over 2 hours of video content**. Here's a preview of what you'll learn in each module:

After completing Craft a Custom React Hook npm Package with React and TypeScript, students now possess the skills to build amazing React Hooks with React and TypeScript.

What the Students are Saying

react

typescript

Organize and abstract away complexity with React Hooks.

19 Video Lessons on React and TypeScript

Interactive, Live Project Demos

Complete Project Source Code

### Master the Art of Building Advanced React Hooks with TypeScript

Welcome to "Master Custom React Hooks with TypeScript," a comprehensive online course designed to elevate your skills in React development, more preciesly in creating Custom React Hooks with TypeScript. Led by seasoned software engineer Chris Frewin, this course dives into the intricacies of building custom and open-source React Hooks using TypeScript.

### Why React Hooks are Such a Pain to Learn

Learning React Hooks can be a formidable journey, especially for seasoned engineers venturing into new territories. Add TypeScript to the mix and the challenge becomes even greater. Here are common challenges you may have encountered:

- The official React documentation is infamous for its lack of complex examples, and it's even harder to find production-ready examples using both React and TypeScript combined. 
- The intricacies of React Hooks and TypeScript may seem daunting, leading to a sense of overwhelm as you navigate through the complexities of these technologies.
- Integrating TypeScript seamlessly with React and understanding how to leverage it effectively can be a puzzle, causing frustration for those aiming to build robust applications.
- Mastering state management with React Hooks requires a deep understanding of React fundamentals. Many face challenges in effectively utilizing useState, useEffect, and other hooks for optimal application performance. One of these most famous pitfalls is the infinite re-render loop that can occur when using useEffect.

### How This Course Helps

This course addresses these frustrations head-on, providing you with practical lessons filled with code implementations based on real-world experience to navigate the complexities of React Hooks and TypeScript with confidence.

### Why Invest Your Time in React Hooks and TypeScript Now?

In the dynamic landscape of software development, staying current is crucial. Here's why learning React Hooks and TypeScript is not just beneficial but essential for software engineers like yourself:

1. **React with React Hooks and TypeScript reigns as the Gold Standard of Web Development:** Even today, React is still oen of the most popular JavaScript frontend framework. By mastering React Hooks and TypeScript, you position yourself at the forefront of modern web development, ensuring your skill set aligns with the latest industry standards.

2. **Enhanced Developer Productivity:** TypeScript's static typing and React's declarative approach can significantly boost your productivity, allowing you to catch errors early and streamline your development workflow.

3. **Industry Demand:** Employers increasingly seek developers well-versed in React Hooks and TypeScript. Adding these skills to your arsenal makes you a sought-after professional in today's competitive job market.

4. **Optimized Application Performance:** React Hooks provide a more efficient and scalable way to manage state and side effects, contributing to the creation of high-performance applications that meet user expectations.

5. **Community Support and Resources:** The React and TypeScript communities are thriving. Learning these technologies now means tapping into a vast pool of resources, support forums, and collaborative opportunities.

Investing your time in mastering React Hooks and TypeScript not only equips you with cutting-edge skills but also positions you for success in the ever-evolving field of software development allowing you to join the ranks of forward-thinking developers embracing these technologies.

### Course Content Overview
Course Overview: Total Modules: **4** Total Lessons: **19** Total Video Runtime: **2 hours, 19 minutes**

Build Powerful React Hooks with TypeScript

Learn how to build an advanced React Hook with TypeScript, you will start from a blank editor and end with a complete and published open-source npm package.
This course contains 19 lessons, each complete with live coding examples for students to study and build upon. 
By the end of the course, you'll have built an extremely clean React Hook and published it to npm with multiple features, documentation, and a fully interactive example site. Along the way, you'll also learn best practices around using TypeScript with React Hooks.

Master Custom React Hooks with TypeScript

Build a powerful hook that enables complex functionality with just one line in a component of your choice.

Build a React Hook npm package with built-in TypeScript type declarations.

Build an example site that updates the hook's properties in real-time.

How to craft **custom React Hooks using TypeScript**

Importance of the **full lifecycle** (mount, unmount, and more) of React Hooks

How to **integrate TypeScript types** with custom React Hooks

What problems **TypeScript with React Hooks** can solve

How to create a **community-ready** custom React Hook package that is a **joy to use**

How to add basic functionalities including **Title Looping**, **Packaging the Module** using **Roolup**, and **Cleaning Up and Refactoring** just to name a few.

How to add advanced functionalities including the immplementation of **Cascading Letter**, **Marquee**, **Favicon Modification**, **Interval Time as a Hook Parameter**, and **Should Always Plas as Hook Parameter** just to name a few.

 How to implement optimization such as **Custom Types**, **Development-only Warning Logger**, preventing concurent usages of the Hook, restoring origional values on **Refocus** and **Unmount**, and more.

You may want the animation to play at all times, instead of only when the window is not in focus. Achieve this by adding a boolean parameter 

import { useState } from "react";
import { AnimationType } from "../enums/AnimationType";
import { useFaviconChangeEffect } from "./useFaviconChangeEffect";
import { useListenToVisibilityChangeOnMount } from "./useListenToVisibilityChangeOnMount";
import { useTitleChangeEffect } from "./useTitleChangeEffect";

export const usePleaseStay = (
  titles: string[],
  animationType: AnimationType,
  faviconLinks: string[],
  interval: number,
  shouldAlwaysPlay: boolean
) => {
  const [shouldIterateTitles, setShouldIterateTitles] = useState(false);

  // Sets the value of shouldIterateTitles whenever page visibility is lost.
  // Also handles the removal of the event listener during cleanup.
  useListenToVisibilityChangeOnMount(setShouldIterateTitles, shouldAlwaysPlay);

  // Alters the document.title of the page when shouldIterateTitles is true.
  useTitleChangeEffect(titles, shouldIterateTitles, animationType, interval);

  // Alters the favicon of the page when shouldIterateTitles is true.
  useFaviconChangeEffect(faviconLinks, shouldIterateTitles, interval);
};

. However, if this value changes, add it to the dependency array. This approach avoids creating the 

import { useEffect } from "react";

export const useListenToVisibilityChangeOnMount = (
  setShouldIterateTitles: (shouldIterateTitles: boolean) => void,
  shouldAlwaysPlay: boolean
) => {
  // Event handler for visibilitychange.
  const handleVisibilityChange = () => {
    setShouldIterateTitles(document.visibilityState !== "visible");
  };

  // Adds the event listener on mount of this hook, and removes it on unmount.
  useEffect(() => {
    if (shouldAlwaysPlay) {
      setShouldIterateTitles(true);
      return;
    }
    document.addEventListener("visibilitychange", handleVisibilityChange);
    return () => {
      document.removeEventListener("visibilitychange", handleVisibilityChange);
    };
  }, [shouldAlwaysPlay]);
};

---
title: Add Should Always Play as a Hook Parameter
code: https://gitlab.com/fullstackio/books/master-custom-react-hooks-with-typescript/-/blob/production/course/code/lesson-12
isPublicLesson: true
useMdx: true
privateVideoUrl: https://stream.mux.com/42HjR0002lIEeYYIGXpWqlfgCFjBtiPy01ygbFj02Pl9GHo.m3u8
---

You may want the animation to play at all times, instead of only when the window is not in focus. Achieve this by adding a boolean parameter `shouldAlwaysPlay` to the `useAnimation` hook, and forwarding it on to `useListenToVisibilityChangeOnMount`:

```ts
import { useState } from "react";
import { AnimationType } from "../enums/AnimationType";
import { useFaviconChangeEffect } from "./useFaviconChangeEffect";
import { useListenToVisibilityChangeOnMount } from "./useListenToVisibilityChangeOnMount";
import { useTitleChangeEffect } from "./useTitleChangeEffect";

export const usePleaseStay = (
  titles: string[],
  animationType: AnimationType,
  faviconLinks: string[],
  interval: number,
  shouldAlwaysPlay: boolean
) => {
  const [shouldIterateTitles, setShouldIterateTitles] = useState(false);

  // Sets the value of shouldIterateTitles whenever page visibility is lost.
  // Also handles the removal of the event listener during cleanup.
  useListenToVisibilityChangeOnMount(setShouldIterateTitles, shouldAlwaysPlay);

  // Alters the document.title of the page when shouldIterateTitles is true.
  useTitleChangeEffect(titles, shouldIterateTitles, animationType, interval);

  // Alters the favicon of the page when shouldIterateTitles is true.
  useFaviconChangeEffect(faviconLinks, shouldIterateTitles, interval);
};
```

Chris Frewin

It may be the case that the user of our hook wants the animation to be playing

instead of only when the window is not in focus.

This can be done by adding a Boolean parameter should always play to the use,

And I'm going to forward that on to the use, listen to visibility change on

And within use, listen to visibility change on mount.

And I'm going to hook that into the existing use effect.

And the only modification is here, if should always play is true,

then we're going to call set should iterate titles to true and return.

We can save everything and rebuild our hook.

And moving into the example project within app.tsx,

I'm going to pass true to should always play.

And if we start up the application, we can see that even though we are

on this tab and regardless of if we lose focus, we always see the three second

the two titles and fav icons that we've set up, which is exactly what we expect

So in summary, we added a new parameter to the use, please stay hook called

We forwarded this parameter on to the use, listen to visibility change on mount

And we added it to the dependency array of the use effect hook here.

And if it's true, we immediately call set should iterate titles to true and we

That's everything for module two. We've built all the features for the hook.

In module three, we will make some final optimizations and improvements to

experience and usage of our hook. And then we will publish our hook to npm.