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:
- Clone the repo via:
git clone https://github.com/project-slippi/slippi-launcher.git - Navigate into the directory and run:
yarn installto install all dependencies - Use
yarn run devto develop - Use
yarn run packageto build a release
For development, we recommend using VSCode with the following plugins:
These extensions will provide automatic formatting and warnings about code quality issues before you commit/push.
common- Code shared between both
mainandrendererprocesses. Thus the code written should be agnostic to which thread its being imported from.
- Code shared between both
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.
- 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- 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.
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.