Remix seamlessly supports both JavaScript and TypeScript. If you name a file with a .ts
or .tsx
extension, it will treat it as TypeScript (.tsx
is for TypeScript files with JSX in them). But it isn't required. You can write all your files as .js
files if you don't want TypeScript.
The Remix compiler will not do any type checking (it simply removes the types). If you want to do type checking, you'll want to use TypeScript's tsc
CLI yourself. A common solution is to add a typecheck
script to your package.json:
{
"name": "remix-app",
"private": true,
"sideEffects": false,
"scripts": {
"build": "remix build",
"dev": "remix dev",
"start": "remix-serve build",
"typecheck": "tsc"
},
"dependencies": {
"@remix-run/node": "latest",
"@remix-run/react": "latest",
"@remix-run/serve": "latest",
"react": "^17.0.2",
"react-dom": "^17.0.2"
},
"devDependencies": {
"@remix-run/dev": "latest",
"@remix-run/eslint-config": "latest",
"@types/react": "^17.0.38",
"@types/react-dom": "^17.0.11",
"eslint": "^8.23.1",
"typescript": "^5.0.4"
},
"engines": {
"node": ">=14.0.0"
}
}
Then you can run that script as part of continuous integration, alongside your tests.
Remix has TypeScript type definitions built-in as well. The starter templates create a remix.env.d.ts
file that is referenced by the tsconfig.json
:
{
"include": ["remix.env.d.ts", "**/*.ts", "**/*.tsx"],
"compilerOptions": {
"lib": ["DOM", "DOM.Iterable", "ES2019"],
"isolatedModules": true,
"esModuleInterop": true,
"jsx": "react-jsx",
"moduleResolution": "node",
"resolveJsonModule": true,
"target": "ES2019",
"strict": true,
"allowJs": true,
"forceConsistentCasingInFileNames": true,
"baseUrl": ".",
"paths": {
"~/*": ["./app/*"]
},
// Remix takes care of building everything in `remix build`.
"noEmit": true
}
}
/// <reference types="@remix-run/dev" />
/// <reference types="@remix-run/node" />
remix.env.d.ts
will depend on which environment you're running your app in. For example, there are different globals available in Cloudflare.