Skip to content

Commit f245089

Browse files
committed
update readme
1 parent 77ffe01 commit f245089

File tree

2 files changed

+44
-20
lines changed

2 files changed

+44
-20
lines changed

README.md

Lines changed: 44 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,32 @@ This project is still in the early stages of development, so there may be bugs a
1111
## Table of Contents
1212

1313
- [Introduction](#introduction)
14+
- [Prerequisites](#prerequisites)
1415
- [Installation](#installation)
1516
- [Usage](#usage)
17+
- [Folder Structure](#folder-structure)
18+
- [Storybook](#storybook)
19+
- [Package (create .exe)](#package-create-exe)
20+
- [Testing](#testing)
21+
- [Linting](#linting)
1622
- [Contributing](#contributing)
1723
- [License](#license)
1824

1925
## Introduction
2026

2127
This project is built with React and Electron and uses the iRacing SDK to retrieve data from the iRacing live telemetry memory-map.
2228

29+
## Prerequisites
30+
31+
- Node.js (v20 or higher)
32+
- npm (comes with Node.js)
33+
- Windows build tools if you are on Windows
34+
- `npm install -g windows-build-tools` from an elevated PowerShell (run as Administrator).
35+
- See [this guide](https://github.com/Microsoft/nodejs-guidelines/blob/master/windows-environment.md#compiling-native-addon-modules) for more details and alternative methods.
36+
- iRacing installed on your machine (Windows only)
37+
38+
> Note: Developing on MacOS is fully supported and does not require iRacing or any additional tools to be installed as it uses a mocked SDK.
39+
2340
## Installation
2441

2542
To install IRDashies, follow these steps:
@@ -34,25 +51,10 @@ To install IRDashies, follow these steps:
3451
```bash
3552
npm start
3653
```
37-
38-
### Generating tracks.json
39-
40-
Since the track map relies on some iRacing assets this should be generated by the user and not committed to the repository.
41-
42-
To generate the `tracks.json` file used for the track map, create a .env file in the root of the project with the following content:
43-
44-
```
45-
IRACING_USERNAME=your-iracing-username
46-
IRACING_PASSWORD=your-iracing-password
47-
```
48-
49-
This account needs to have access to the data API (see the following for details on how to enable legacy authentication: https://support.iracing.com/support/solutions/articles/31000173894-enabling-or-disabling-legacy-read-only-authentication).
50-
51-
Then run the following command:
52-
53-
```bash
54-
npm run generate-assets
55-
```
54+
5. Optionally, you can run the storybook to view the components in isolation:
55+
```bash
56+
npm run storybook
57+
```
5658

5759
## Usage
5860

@@ -62,7 +64,7 @@ npm start
6264
```
6365
This will start the application.
6466

65-
Look for the application in your app tray. Right-click on the icon and Lock / Unlock to resize and move overlays around.
67+
Look for the application in your app tray.
6668

6769
> You will need to have Node.js installed on your machine to run the application. You can download it from [here](https://nodejs.org/).
6870
@@ -115,6 +117,22 @@ To create the .exe and the installer run the following:
115117
npm run make
116118
```
117119

120+
## Testing
121+
122+
To run the tests, run the following command:
123+
```bash
124+
npm run test
125+
```
126+
127+
## Linting
128+
129+
To run the linting, run the following command:
130+
```bash
131+
npm run lint
132+
```
133+
134+
> Ensure you have ESLint extension installed if using VS Code and have enabled "Use Flat Config" in your settings.
135+
118136
## Developing on Mac
119137

120138
As you may know, the iRacing SDK is only available on Windows. To develop on Mac OS, there is a mock SDK that is loaded which generates some dummy data for you to work with. This is useful for developing the UI components and widgets.
@@ -149,6 +167,12 @@ Displays a track map with the current position of the cars on track and the trac
149167
150168
![Track Map](./docs/assets/trackmap.png)
151169

170+
### Weather
171+
172+
Displays the weather information for the current session.
173+
174+
![Weather](./docs/assets/weather.png)
175+
152176
## Contributing
153177

154178
We welcome contributions to the IRDashies project! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request.

docs/assets/weather.png

41 KB
Loading

0 commit comments

Comments
 (0)