Onboarding React Developers to Typescript

This ad is not shown to multipass and full ticket holders
JSNation US
JSNation US 2025
November 17 - 20, 2025
New York, US & Online
See JS stars in the US biggest planetarium
Learn More
In partnership with Focus Reactive
Upcoming event
JSNation US 2025
JSNation US 2025
November 17 - 20, 2025. New York, US & Online
Learn more
Bookmark
Rate this content

Your team has just hired a React Developer to work on your Typescript codebase. Both your team and the new engineer are eager to start building features, but they only have experience writing Javascript. How can you quickly onboard the engineer to Typescript while still providing them with time and space needed to learn the language effectively? In this talk, we’ll discuss why Typescript fundamentals, like function types, interfaces, and generics, can be intimidating for learners. Then, we’ll walk through successful, practical approaches for teaching each of these concepts and relating them back to React. By the end of this talk, you’ll have the building blocks for creating a fruitful onboarding session for your engineers.

This talk has been presented at TypeScript Congress 2022, check out the latest edition of this JavaScript Conference.

FAQ

The key technologies mentioned are React, TypeScript, and Next.js.

The main topic is best practices for onboarding React developers to TypeScript.

The speaker is Silvana Santos, a software engineer at Codecademy.

Engineers can feel overwhelmed by the syntax, find the files more robust than JavaScript, and feel like TypeScript is working against them, especially if they have never worked with statically typed languages.

The three principles are: create a safe space, draw parallels between known and new concepts, and enable discovery.

The preferred format is a workshop that includes an introduction, pair programming challenges, and a wrap-up session.

Each group should consist of two to three learners and one mentor. The session should be driven by the learners, with the mentor providing support when needed.

Challenges include prompts, hints, and solutions. They cover topics like function annotations and React functional components.

The documentation should guide learners through challenges, provide hints, and include code snippets of the solutions.

Challenges are broken down into multiple parts to cover different syntaxes and make the topics more digestible.

Sylvana Santos
Sylvana Santos
19 min
29 Apr, 2022

Comments

Sign in or register to post your comment.
Video Summary and Transcription
Today's Talk discusses best practices for onboarding React developers to TypeScript, including pain points faced by engineers, principles for effective onboarding, and a workshop format. The workshop covers function type expressions, annotating React functional components, and the return type of React functional components. The session emphasizes creating a safe space for hands-on practice and gradually exposing engineers to TypeScript concepts. Overall, the Talk aims to improve onboarding experiences for React developers learning TypeScript.

1. Introduction

Short description:

Hi there, my name is Silvana Santos and today I'll be walking you through best practices for onboarding React developers to TypeScript. I am a software engineer at Codecademy, passionate about knowledge sharing and advocating for budding engineers. I hope to offer a fresh perspective on onboardings.

Hi there, my name is Silvana Santos and today I'll be walking you through what I believe are some best practices for onboarding React developers to TypeScript. So a little bit about me. I am a software engineer at Codecademy. I work in React, TypeScript, Next.js as well as some back-end technologies and I'm passionate about knowledge sharing and advocating for budding engineers at my company. This is something that's particularly important to me because it wasn't that long ago that I started my own journey to software engineering. So I'm always eager to support those in their journey as well. And so I hope that today I can offer a bit of a fresh perspective on onboardings since it's normally something that engineering managers or senior engineers handle.

2. Pain Points and Principles

Short description:

Today's agenda includes discussing pain points faced by engineers when learning TypeScript, principles for creating an effective onboarding experience, and a recap of key takeaways. Engineers often feel overwhelmed by the robustness of TypeScript files and struggle to identify familiar syntax. TypeScript can feel like it's working against them, especially for those new to statically typed languages. Creating a safe space, drawing parallels to familiar concepts, and enabling discovery are key principles for effective onboarding.

So the agenda for today. First, we'll discuss some pain points that many engineers, including myself, face when they are learning TypeScript for the first time. Then we'll identify some principles that you can follow to ensure that you are creating an effective onboarding experience. And then most of our time will be spent examining what an effective onboarding experience might look like. And then we'll do a quick recap of all of the key takeaways from today's session.

So pain points. From the moment that an engineer first opens up a TypeScript file, they can start to feel pretty overwhelmed. When you aren't familiar with the syntax, TypeScript can look pretty scary. The files are much more robust than the JavaScript files that they might be used to. And so becomes really difficult for them to identify the syntax that they're already familiar with versus the syntax that they aren't familiar with. And once they get past that initial shock and start actually doing a bit of work in TypeScript, they can start to feel like TypeScript is working against them, not with them the way that so many people claim it will. And this is especially true for engineers who have never worked with statically typed languages. It can feel like you fix one compilation error and all of a sudden ten more appear in its place. So, it can get pretty frustrating.

So, with those pain points in mind, we can establish some principles that will help us shape our onboardings. These are just three principles that I try to keep in mind when I'm building these experiences. So, first is create a safe space. This starts with encouraging learners to ask questions and reach out for help. Even beyond the onboarding itself. But it can be much more than that. Sharing your own experiences, learning a new language or technology and talking about the struggles that you face along the way can really go long way in comforting an engineer as they are learning Typescript. The second principle that I try to follow is drawing parallels. Whenever possible, it's great to connect the things that they are trying to learn to the things that they already know really well. So, for example, if you're trying to teach a Typescript concept, it's great when you can connect it to work that they've done in React. Or if the engineer has worked in Java before, then you can connect the Java syntax to the Typescript syntax. The third principle that I try to follow is enable discovery. Most people don't retain information very well when they're just passively listening. It's much better to have people try things out on their own. So, whenever possible, I try to help learners discover the power of Typescript on their own.

So at this point, we've discussed pain points that learners can face along their learning journey.

3. Onboarding Format and Challenges

Short description:

Workshops are an effective format for onboarding. The session starts with introductions and an overview of TypeScript's value. Pair programming is the focus, with small groups working on challenges. The pairing time is crucial, with groups consisting of learners and a mentor. Challenges have prompts, hints, and answers. Function annotations can be challenging due to the need for TypeScript fundamentals and multiple syntaxes. Address these difficulties by covering the basics first and breaking the challenge into parts.

And we've also identified some principles that we can follow to make a more effective onboarding experience. But you might be thinking, what is this actually going to look like in practice? Well, let's dive into that. So, there's obviously many different ways that you can format an onboarding experience, but I have found that workshops really embody the principles that we just talked about. So, this is the format that I normally follow.

The first 5 to 10 minutes are used to kick off the meeting. It's a time for everyone in the session to get to know each other. And then you can introduce what TypeScript is and why it's valuable to your company. Then a majority of the time will be spent pair programming. The engineers in the session will be broken up into small groups where they will work together to accomplish small challenges. And then the final 5 to 10 minutes will be used to wrap up the session. This is a time for you to address any lingering questions, share resources for engineers to continue their learning journey, and collect feedback on their experience.

So as I said, the biggest and most important part of the onboarding experience of the workshop is the pairing time. So there are two things that you can do to ensure that this time is purposeful. The first is that you should ensure that each group has two to three learners and one mentor. The session should be driven by the learners but the mentor is there to help unblock them or answer any questions that may come up as they are working through the challenges. The second thing that you should do is provide learners with a document that guides them through those challenges and we'll take a look at what documentation might look like later on.

So at this point you've heard me mention challenges a few times and you might be wondering what is a challenge? What does a challenge look like? So I break up challenges into three parts. The first is the prompt this is telling the group what task you want them to complete. Then that's followed by a hint or multiple hints that will help them when they get stuck. This is a chance for you to share resources on the topic or provide them with clues to help them make progress. And hopefully after they receive some hints and maybe some guidance from the mentor they're able to come up with a solution and they can check their solution against the answer which is just a code snippet of the solution.

So in order to get a better sense of what a challenge might look like let's focus in on the topic of function annotations. So whenever you're trying to build a challenge around a specific topic there are two things that you'll want to ask yourself. First is, what might make this topic difficult for learners to understand? In the case of function annotations there are two reasons why learners might find it difficult. The first is that writing function annotations requires you to have the TypeScript fundamentals down and when you've literally just learned this a few minutes ago or 30 minutes ago it can be really hard to recall that information and also be asked to build on top of that information. The second thing that might make function annotations difficult is that you can annotate functions using many different syntaxes. So it can be really easy for learners to jumble up the syntaxes and so at this point you should ask yourself how can I address these difficulties? How can I make this topic more digestible? And so in the case of function annotations there's two things that you can do here. First is ensure that your learners have gotten the basics down before taking on this challenge and so that means you should build a challenge that covers the basics and have them do that first. The second thing that you'll want to do is to break up this challenge into multiple parts and that allows you to cover different syntaxes in each part. So let's take a look at what the challenge might look like.

4. Function Type Expressions

Short description:

Part A focuses on practicing the syntax of function type expressions. Learners are given a list of functions with different inputs and outputs. If they get stuck, we direct them to the docs and provide a breakdown of the syntax. By comparing function annotations to variable declarations, they can come up with their own solutions. We also provide answers and links to a TypeScript playground for interactive learning.

So part A asks the learners a list of functions using a function type expression. So you can see here we have different functions that all have different inputs and different outputs to get them practicing the syntax with a bunch of different functions. And so if the learner gets stuck along the way, the first thing that we do is that we direct them to the docs. If that doesn't help, then we give them a little breakdown of the syntax and try to connect it to something they already learned in a previous challenge.

So here you can see that we're showing them how they are used to, how they should be declaring a basic string variable, and then we're comparing that to how you would use that same annotation on a function. So in this case, you just have your variable name followed by a colon. And whatever follows the colon is the type. And then whatever follows the equal sign is the value, the same way that you would normally do it in JavaScript. So hopefully, with those hints, they are able to come up with their own solution and compare it to our answers here. And one thing to point out is that these links that you have seen in the previous slides, they lead to a TypeScript playground, so that this is very interactive and they have a place to sort of play around with code. Yeah. So as you can see here, we provided them with the answers so they can see how the syntax will look with different types of functions that all have different inputs and outputs.

5. Part B: Annotating React Functional Components

Short description:

This challenge asks learners to add parameter and return type annotations to the same list of functions they examined in part A. We provide hints and breakdowns of the syntax to help them understand. The learners are now ready to annotate React functional components. In part A, they create an interface to define the shape of the props. We guide them to the docs and provide a clue to help them. In part B, they annotate the component using function type expression or parameter/return type annotation, with different hints provided.

Onto part B. So this challenge asks learners to add parameter and return type annotations to the same list of functions that they examined in part A. And so this allows for continuity and also makes it a lot easier for learners to compare the different syntaxes. And so, again, with the hints, we direct them to the docs. We want to get them familiar with working in the TypeScript docs. But if that is not enough, then we also provide them with a little breakdown of the syntax. And, again, we're sort of highlighting that the syntax here by saying you are annotating the parameter here the same way that you would in a variable declaration. And then we have this new sort of syntax of having a colon after the parameter and whatever follows that colon is the return type annotation. And so, once again, with those hints and with the help of their mentor, hopefully they arrive at their own solution, which they can compare to our answers that we provide them in the document.

So, at this point we have given them enough information for them to be able to annotate React functional components. Now, obviously, there's a lot more to function annotations, so we could definitely add more things to the previous challenge. For example, we could tell them to refactor their annotations using type aliases or something like that. But, as I said, at this point they have the bare minimum knowledge to be able to annotate React functional components. So, again, for this topic, we're going to want to break up the challenge into multiple parts. So, part A, ask the learners to create an interface that defines the shape of the props in the component. So, again, we want to make sure in the component. We want to make this digestible. We start with a small portion of the task. As you can see here, we have a component called curriculum card. And all it does is it takes in an object which contains a title, a description, and displays that. So if learners get stuck in trying to annotate or in trying to create the interface for the props of that component, we first guide them to the docs. But here we also give them a little clue and we tell them if you're not sure about the shape of the props, how about you take a look at where we're deconstructing the props. That might help you out. And so hopefully with the docs and the hint there, they're able to come up with their answer and come up with this interface here. And also one thing to note is that at some point, maybe in that challenge that we had on the beginning with basics, you should cover interfaces. This should not be the first time that the learners are seeing interfaces. There's just not enough time in this workshop or in this talk to have shown that, but just want to caveat that this should not be the first time that your learners are seeing interfaces.

Cool, so on to part B, which asks learners to annotate the component using either a function type expression or a parameter slash return type annotation. So again, using the same component from part A, this time we provide them with slightly different hints.

6. React Functional Component Return Type

Short description:

Using the same component from part A, we provide slightly different hints. We ask learners the return type of a React functional component, nudging them towards 'a React node.' We acknowledge that this answer is not completely accurate and provide the correct explanation later. One thing at a time.

So again, using the same component from part A, this time we provide them with slightly different hints. So no docs this time. What we tell them is, that first, they're going to need the interface that they created in part A. So that's a big hint. And then second, we actually ask them a question first. We ask them, what is the return type of a React functional component? And hopefully you would have this in some sort of toggle, so that they have a minute to think about it. And if they're not sure, we sort of give them the answer here. And we say, a React node, that's the return type. Now, that's not completely accurate, but we're sort of trying to nudge them in that direction. And maybe further down the line, we can explain that that's not completely accurate. And so, we give that caveat to them. Don't worry, you might be a little confused about where this is coming from or what it is. Don't worry about it for now. One thing at a time. And so, again, we provide them with the answer here. In the link, I show them how to do it with the two different syntaxes. But just for the purposes of this slide, I showed one of the syntaxes.

7. Workshop Structure and Recap

Short description:

After discussing the challenges, difficulties, and topics, the workshop would cover basic types, function annotations, and React functional components. The session can be customized to enforce best practices, such as adding challenges on generics and the React.fc type. In summary, learning TypeScript can be tough, so creating a safe space for hands-on practice through workshops is recommended. Slowly exposing engineers to TypeScript concepts and culminating in a React use case is effective. Thank you for watching the session and I hope it helps improve your onboarding experiences.

Amazing. So, after going through this process of sort of building the challenges, talking about the difficulties and each of the topics. This is what the workshop would look like. We would have challenge one, which covers basic types. This is not something that I explicitly showed in the session today. But it was something that we said that they need for challenge two, which covers function annotations. And then once they have that knowledge of function annotations, they should be in a spot where they can take on challenge three, which is React functional components.

And so, obviously, there's so many things that you can cover in this session. You can build out function annotations more. You can add other topics. You can really tailor this to help enforce the best practices that you use at your company. So, for example, you could add a challenge four, which covers generics, and that will help prime them for challenge five which covers which revisits React functional components, but this time introduces them to the React.fc type. So, that's just an example of maybe how you would want to build on top of this sort of base that we covered here today.

And so, let's go ahead and recap everything we covered. First, learning TypeScript can be tough. I can tell you firsthand that TypeScript was not something that was intuitive to me. It took a lot of tries for me to have that ah-ha moment. So, with that in mind, you should try to make your onboardings a safe space where your learners can get hands-on practice with TypeScript. And workshops can be a really great format for accomplishing that goal. And when you are creating workshops, if you decide that, that's the right format for you, you should slowly expose engineers to TypeScript concepts, and that should all culminate in a React use case as we saw here today. So that is all I have for you. I appreciate you taking the time to watch my session. I hope that you figured out some ways to improve or maybe if you're building from scratch your onboarding experiences.

Check out more articles and videos

We constantly think of articles and videos that might spark Git people interest / skill us up or help building a stellar career

A Guide to React Rendering Behavior
React Advanced 2022React Advanced 2022
25 min
A Guide to React Rendering Behavior
Top Content
This transcription provides a brief guide to React rendering behavior. It explains the process of rendering, comparing new and old elements, and the importance of pure rendering without side effects. It also covers topics such as batching and double rendering, optimizing rendering and using context and Redux in React. Overall, it offers valuable insights for developers looking to understand and optimize React rendering.
Building Better Websites with Remix
React Summit Remote Edition 2021React Summit Remote Edition 2021
33 min
Building Better Websites with Remix
Top Content
Remix is a web framework built on React Router that focuses on web fundamentals, accessibility, performance, and flexibility. It delivers real HTML and SEO benefits, and allows for automatic updating of meta tags and styles. It provides features like login functionality, session management, and error handling. Remix is a server-rendered framework that can enhance sites with JavaScript but doesn't require it for basic functionality. It aims to create quality HTML-driven documents and is flexible for use with different web technologies and stacks.
Don't Solve Problems, Eliminate Them
React Advanced 2021React Advanced 2021
39 min
Don't Solve Problems, Eliminate Them
Top Content
Kent C. Dodds discusses the concept of problem elimination rather than just problem-solving. He introduces the idea of a problem tree and the importance of avoiding creating solutions prematurely. Kent uses examples like Tesla's electric engine and Remix framework to illustrate the benefits of problem elimination. He emphasizes the value of trade-offs and taking the easier path, as well as the need to constantly re-evaluate and change approaches to eliminate problems.
React Compiler - Understanding Idiomatic React (React Forget)
React Advanced 2023React Advanced 2023
33 min
React Compiler - Understanding Idiomatic React (React Forget)
Top Content
Watch video: React Compiler - Understanding Idiomatic React (React Forget)
Joe Savona
Mofei Zhang
2 authors
The Talk discusses React Forget, a compiler built at Meta that aims to optimize client-side React development. It explores the use of memoization to improve performance and the vision of Forget to automatically determine dependencies at build time. Forget is named with an F-word pun and has the potential to optimize server builds and enable dead code elimination. The team plans to make Forget open-source and is focused on ensuring its quality before release.
Using useEffect Effectively
React Advanced 2022React Advanced 2022
30 min
Using useEffect Effectively
Top Content
Today's Talk explores the use of the useEffect hook in React development, covering topics such as fetching data, handling race conditions and cleanup, and optimizing performance. It also discusses the correct use of useEffect in React 18, the distinction between Activity Effects and Action Effects, and the potential misuse of useEffect. The Talk highlights the benefits of using useQuery or SWR for data fetching, the problems with using useEffect for initializing global singletons, and the use of state machines for handling effects. The speaker also recommends exploring the beta React docs and using tools like the stately.ai editor for visualizing state machines.
Routing in React 18 and Beyond
React Summit 2022React Summit 2022
20 min
Routing in React 18 and Beyond
Top Content
Routing in React 18 brings a native app-like user experience and allows applications to transition between different environments. React Router and Next.js have different approaches to routing, with React Router using component-based routing and Next.js using file system-based routing. React server components provide the primitives to address the disadvantages of multipage applications while maintaining the same user experience. Improving navigation and routing in React involves including loading UI, pre-rendering parts of the screen, and using server components for more performant experiences. Next.js and Remix are moving towards a converging solution by combining component-based routing with file system routing.

Workshops on related topic

React Performance Debugging Masterclass
React Summit 2023React Summit 2023
170 min
React Performance Debugging Masterclass
Top Content
Featured Workshop
Ivan Akulov
Ivan Akulov
Ivan’s first attempts at performance debugging were chaotic. He would see a slow interaction, try a random optimization, see that it didn't help, and keep trying other optimizations until he found the right one (or gave up).
Back then, Ivan didn’t know how to use performance devtools well. He would do a recording in Chrome DevTools or React Profiler, poke around it, try clicking random things, and then close it in frustration a few minutes later. Now, Ivan knows exactly where and what to look for. And in this workshop, Ivan will teach you that too.
Here’s how this is going to work. We’ll take a slow app → debug it (using tools like Chrome DevTools, React Profiler, and why-did-you-render) → pinpoint the bottleneck → and then repeat, several times more. We won’t talk about the solutions (in 90% of the cases, it’s just the ol’ regular useMemo() or memo()). But we’ll talk about everything that comes before – and learn how to analyze any React performance problem, step by step.
(Note: This workshop is best suited for engineers who are already familiar with how useMemo() and memo() work – but want to get better at using the performance tools around React. Also, we’ll be covering interaction performance, not load speed, so you won’t hear a word about Lighthouse 🤐)
Next.js for React.js Developers
React Day Berlin 2023React Day Berlin 2023
157 min
Next.js for React.js Developers
Top Content
Featured WorkshopFree
Adrian Hajdin
Adrian Hajdin
In this advanced Next.js workshop, we will delve into key concepts and techniques that empower React.js developers to harness the full potential of Next.js. We will explore advanced topics and hands-on practices, equipping you with the skills needed to build high-performance web applications and make informed architectural decisions.
By the end of this workshop, you will be able to:1. Understand the benefits of React Server Components and their role in building interactive, server-rendered React applications.2. Differentiate between Edge and Node.js runtime in Next.js and know when to use each based on your project's requirements.3. Explore advanced Server-Side Rendering (SSR) techniques, including streaming, parallel vs. sequential fetching, and data synchronization.4. Implement caching strategies for enhanced performance and reduced server load in Next.js applications.5. Utilize React Actions to handle complex server mutation.6. Optimize your Next.js applications for SEO, social sharing, and overall performance to improve discoverability and user engagement.
Concurrent Rendering Adventures in React 18
React Advanced 2021React Advanced 2021
132 min
Concurrent Rendering Adventures in React 18
Top Content
Featured Workshop
Maurice de Beijer
Maurice de Beijer
With the release of React 18 we finally get the long awaited concurrent rendering. But how is that going to affect your application? What are the benefits of concurrent rendering in React? What do you need to do to switch to concurrent rendering when you upgrade to React 18? And what if you don’t want or can’t use concurrent rendering yet?

There are some behavior changes you need to be aware of! In this workshop we will cover all of those subjects and more.

Join me with your laptop in this interactive workshop. You will see how easy it is to switch to concurrent rendering in your React application. You will learn all about concurrent rendering, SuspenseList, the startTransition API and more.
React Hooks Tips Only the Pros Know
React Summit Remote Edition 2021React Summit Remote Edition 2021
177 min
React Hooks Tips Only the Pros Know
Top Content
Featured Workshop
Maurice de Beijer
Maurice de Beijer
The addition of the hooks API to React was quite a major change. Before hooks most components had to be class based. Now, with hooks, these are often much simpler functional components. Hooks can be really simple to use. Almost deceptively simple. Because there are still plenty of ways you can mess up with hooks. And it often turns out there are many ways where you can improve your components a better understanding of how each React hook can be used.You will learn all about the pros and cons of the various hooks. You will learn when to use useState() versus useReducer(). We will look at using useContext() efficiently. You will see when to use useLayoutEffect() and when useEffect() is better.
Introducing FlashList: Let's build a performant React Native list all together
React Advanced 2022React Advanced 2022
81 min
Introducing FlashList: Let's build a performant React Native list all together
Top Content
Featured Workshop
David Cortés Fulla
Marek Fořt
Talha Naqvi
3 authors
In this workshop you’ll learn why we created FlashList at Shopify and how you can use it in your code today. We will show you how to take a list that is not performant in FlatList and make it performant using FlashList with minimum effort. We will use tools like Flipper, our own benchmarking code, and teach you how the FlashList API can cover more complex use cases and still keep a top-notch performance.You will know:- Quick presentation about what FlashList, why we built, etc.- Migrating from FlatList to FlashList- Teaching how to write a performant list- Utilizing the tools provided by FlashList library (mainly the useBenchmark hook)- Using the Flipper plugins (flame graph, our lists profiler, UI & JS FPS profiler, etc.)- Optimizing performance of FlashList by using more advanced props like `getType`- 5-6 sample tasks where we’ll uncover and fix issues together- Q&A with Shopify team
React, TypeScript, and TDD
React Advanced 2021React Advanced 2021
174 min
React, TypeScript, and TDD
Top Content
Featured Workshop
Paul Everitt
Paul Everitt
ReactJS is wildly popular and thus wildly supported. TypeScript is increasingly popular, and thus increasingly supported.

The two together? Not as much. Given that they both change quickly, it's hard to find accurate learning materials.

React+TypeScript, with JetBrains IDEs? That three-part combination is the topic of this series. We'll show a little about a lot. Meaning, the key steps to getting productive, in the IDE, for React projects using TypeScript. Along the way we'll show test-driven development and emphasize tips-and-tricks in the IDE.