DEV Community

Cover image for Setting up Your First React TypeScript Project From Scratch
Roy Derks
Roy Derks

Posted on • Edited on • Originally published at hackteam.io

Setting up Your First React TypeScript Project From Scratch

Are you looking to create your own React TypeScript project, but don't know where to start? With this blog post, you'll get a comprehensive guide to setting up a React TypeScript project from scratch. We'll discuss the necessary components and considerations for environment setup, creating a basic project structure and running the application. With this comprehensive guide in hand, you'll have all the information you need to get started on your React TypeScript journey and create something truly amazing. So, let's dive in and get started on your React TypeScript project!

Click the image below to watch the YouTube video version of this blog post:

hqdefault.jpg

Installing Create React App

Today, Create React App is the most popular way to create a React project. It's a tool that allows you to create a React project without having to worry about the configuration. It's a great way to get started with React and TypeScript. You can create a new project with Create React App using npx with the following command:

npx create-react-app my-app

Enter fullscreen mode Exit fullscreen mode

This will create a new React project in the my-app directory. Now that your React project is set up, it's time to run the application. You can then run the project with the following command:

cd my-app
npm start
Enter fullscreen mode Exit fullscreen mode

This will start the development server and open the application in your browser in http://localhost:3000. You can now start developing your React TypeScript project!

Note: npx is installed on your machine when you install Node.js.

Installing TypeScript

To use TypeScript in your Create React App project, you need to add a tsconfig.json file that holds the TypeScrupt configuration. You can do this by running the following command:

touch tsconfig.json
Enter fullscreen mode Exit fullscreen mode

And add this configuration to the tsconfig.json file:

{
  "compilerOptions": {
    "outDir": "dist",
    "rootDir": "src",
    "sourceMap": true,
    "noImplicitAny": true,
    "allowJs": true,
    "moduleResolution": "node",
    "module": "commonJS",
    "lib": ["es6", "dom"],
    "target": "ES5",
    "jsx": "react"
  },
  "exclude": ["node_modules", "dist"]
}
Enter fullscreen mode Exit fullscreen mode

To use TypeScript in your project, you only need to restart the development server by running npm start again. This will now compile your TypeScript code to JavaScript and run the application.

Every file in your application can be renamed from js to tsx to use TypeScript. You can also add the ts extension to your files, but it's needed to use tsx for React components as these files contain JSX.

You can now start developing your React TypeScript project!

Allowing synthetic default imports

In your IDE you might see some errors highlighted about synthetic default imports. This is because TypeScript doesn't know how to import the default export from a module. By default, imports in TypeScript have the following syntax:

import * as React from 'React';
Enter fullscreen mode Exit fullscreen mode

If we want to keep importing our modules as we did with Babel, we need to change some settings in our tsconfig.json file:

{
  "compilerOptions": {
    "allowSyntheticDefaultImports": true,
    "esModuleInterop": true,
    ...
  }
}
Enter fullscreen mode Exit fullscreen mode

After this, we can deconstruct our imports again and avoid the obligatory asterisk *:

import React, { FC } from 'react';
Enter fullscreen mode Exit fullscreen mode

This will allow us to import our modules as we did before. But there are more things we should do to make our TypeScript project more robust.

Adding global type definitions

Another highlighted error in your IDE (I'm using VS code) is that it cannot find the type definitions for the SVG files we're importing. To fix this, we need to add this type definition to our project. We can do this by creating a global.d.ts file in the src directory and adding the following code:

declare module '*.svg' {
  const content: string;
  export default content;
}
Enter fullscreen mode Exit fullscreen mode

This will allow us to import SVG files in our project without any errors.

Creating a TypeScript React component

Now that we've set up our project, it's time to create our first TypeScript React component. We can do this by creating a components/Link.tsx file in the src directory and adding the following code:

import * as React from 'react';

type LinkProps = {
  href: string;
  targetBlank: boolean;
  children: React.ReactNode | string;
};

export default function Link({
  href,
  targetBlank = false,
  children,
}: LinkProps) {
  return (
    <a
      className='App-link'
      href={href}
      target={targetBlank ? '_blank' : ''}
      rel={targetBlank ? 'noopener noreferrer' : ''}
    >
      {children}
    </a>
  );
}
Enter fullscreen mode Exit fullscreen mode

This will create a simple Link component that we can use in our application. We can now import this component in our App.tsx file and use it in our application.

For example, we can replace the a tag in the App.tsx file with our Link component:

import * as React from 'react';
import logo from './logo.svg';
import './App.css';
import Link from './components/Link';

function App() {
  return (
    <div className='App'>
      <header className='App-header'>
        <img src={logo} className='App-logo' alt='logo' />
        <p>
          Edit <code>src/App.js</code> and save to reload.
        </p>
        <Link href='https://reactjs.org' targetBlank>
          Learn React
        </Link>
      </header>
    </div>
  );
}

export default App;
Enter fullscreen mode Exit fullscreen mode

This will now render the Link component in our application. You can now start developing your React TypeScript project by adding more components!

Conclusion

By the end of this blog post, you should have all the information you need to get started on React TypeScript development. We've discussed how to set up an environment, create a project structure and run the application. And that’s it! With this comprehensive guide in hand, you now have all the information you need to set up and run your React TypeScript project from scratch. I hope this guide was helpful and wish you luck on your React TypeScript journey!

Good luck and happy coding!

P.S. Follow Roy Derks on Twitter for more React, GraphQL and TypeScript tips & tricks. And subscribe to my YouTube channel for more React, GraphQL and TypeScript tutorials.


This post was originally published on Hackteam using Reposted.io. A free tool to repost your content across all blogging platforms.

Top comments (0)