# Getting Started

Getting started with Retype is super quick and you can be up and running within seconds.

Check out the Quick start for the condensed process or continue here with the detailed instructions.

# Prerequisites

Retype is installed using either npm, yarn, or the dotnet CLI.

You only need one of those three package managers as a prerequisite, although all three could be installed on your computer too. It's up to you. 🙌

Package Manager Supported Platforms
npm Mac Win Linux
yarn Mac Win Linux
dotnet Mac Win Linux

# Install

It takes just a few seconds to install Retype using any of the following commands. Choose the command based on a package manager you have installed on your computer.

npm install retypeapp --global
retype watch
yarn global add retypeapp
retype watch
dotnet tool install retypeapp --global
retype watch

That's it! 🎉 Your new Retype website should be up and running. 🎉

# Platform specific

The default retypapp NPM and Yarn package is a bundle of several platform specific packages. The installer will automatically detect and choose the correct platform package from the bundle during installation.

The bundle provides convenience although at the cost of an increased download size.

It is possible to install smaller platform specific packages without the bundling. Currently, four platforms are supported and can be installed separately.

Platform Install command
retypeapp-win-x86 npm install retypeapp-win-x86 --global
retypeapp-win-x64 npm install retypeapp-win-x64 --global
retypeapp-linux-x64 npm install retypeapp-linux-x64 --global
retypeapp-darwin-x64 npm install retypeapp-darwin-x64 --global

# Update

Update to the latest release of Retype using on of the following commands for the package manager that you initially installed Retype with. For instance, if you used npm to install Retype, run the npm update command to update Retype locally.

npm update retypeapp --global
yarn global upgrade retypeapp
dotnet tool update retypeapp --global

# Uninstall

Done with Retype? It's okay, we understand. 😢

Uninstalling Retype is just as simple as installing. Use the same package manager to uninstall as you did to install. For instance, if you used npm to install Retype, run the npm uninstall command to remove.

npm uninstall retypeapp --global
yarn global remove retypeapp
dotnet tool uninstall retypeapp --global

All Retype related files and folders within your project can be deleted, such as the retype.yml file and the generated .retype folder.