The Slippi Launcher acts as a one stop shop for everything Slippi related. It handles updating Slippi Dolphin, playing Slippi Online, launching and analyzing replays, and more.

This repository is part of the Project Slippi ecosystem. For more information about all of the Project Slippi projects, visit https://github.com/project-slippi/project-slippi.

These are the applications you will need to install in order to build this project:

• Git
• Node v16+
• Yarn

• Clone the repo via: git clone https://github.com/project-slippi/slippi-launcher.git
• Navigate into the directory and run: yarn install to install all dependencies
• Use yarn run start to run the app in develop mode
• Use yarn run package to build a release

For development, we recommend using VSCode with the following plugins:

• ESLint

These extensions will provide automatic formatting and warnings about code quality issues before you commit/push.

• common
  • Code shared between both main and renderer processes. Thus the code written should be agnostic to which thread its being imported from.
• main
  • Code for the main process. e.g. electron config, menubars etc.
• renderer
  • Code for the all the visual components
• <module>
  • Modules for the main process that handles specfic tasks should be kept in their own folder with a clear name.

• components
  • "Dumb" components reusable throughout the app. These should not directly access or modify state but should accept handlers and state info via props.
• containers
  • Components that piece multiple dumb components together into a single "container". These can modify state and bind logic to the components but make sure most complex logic is in lib.
• lib
  • Reusable logic goes here to keep the components mainly representative and visual.
• styles
  • Code for app styles and theming.
• views
  • The root pages of the app. Give a starting point for finding components.

Contributions are welcome! The issues section contains some good first ideas. When making a PR, ensure you are not PRing your main branch and always describe the feature and what testing you've done so far.

This application uses Electron React Boilerplate as a base and includes most changes up to commit 10c22e5.

Slippi Launcher is released as open source software under the GPL v3 license. See the LICENSE file in the project root for the full license text.