You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+44-20Lines changed: 44 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,15 +11,32 @@ This project is still in the early stages of development, so there may be bugs a
11
11
## Table of Contents
12
12
13
13
-[Introduction](#introduction)
14
+
-[Prerequisites](#prerequisites)
14
15
-[Installation](#installation)
15
16
-[Usage](#usage)
17
+
-[Folder Structure](#folder-structure)
18
+
-[Storybook](#storybook)
19
+
-[Package (create .exe)](#package-create-exe)
20
+
-[Testing](#testing)
21
+
-[Linting](#linting)
16
22
-[Contributing](#contributing)
17
23
-[License](#license)
18
24
19
25
## Introduction
20
26
21
27
This project is built with React and Electron and uses the iRacing SDK to retrieve data from the iRacing live telemetry memory-map.
22
28
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
+
23
40
## Installation
24
41
25
42
To install IRDashies, follow these steps:
@@ -34,25 +51,10 @@ To install IRDashies, follow these steps:
34
51
```bash
35
52
npm start
36
53
```
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
+
```
56
58
57
59
## Usage
58
60
@@ -62,7 +64,7 @@ npm start
62
64
```
63
65
This will start the application.
64
66
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.
66
68
67
69
> You will need to have Node.js installed on your machine to run the application. You can download it from [here](https://nodejs.org/).
68
70
@@ -115,6 +117,22 @@ To create the .exe and the installer run the following:
115
117
npm run make
116
118
```
117
119
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
+
118
136
## Developing on Mac
119
137
120
138
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
149
167
150
168

151
169
170
+
### Weather
171
+
172
+
Displays the weather information for the current session.
173
+
174
+

175
+
152
176
## Contributing
153
177
154
178
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.
0 commit comments