Files
suwayomi-material-you-webui/CONTRIBUTING.md
schroda 31dca431e4 Feature/use vite with swc (#400)
* Add vite-env.d.ts

Should have been added with bc99728dcd

* Update readmes

* Use vites SWC plugin
2023-08-11 17:30:22 +02:00

2.0 KiB

Contributing

Where should I start?

Everything from https://github.com/Suwayomi/Tachidesk-Server/blob/master/CONTRIBUTING.md#where-should-i-start applies here.

About this project

Building the app

See BUILDING.md for more information

Release process

  1. Update the changelog
    1. Copy the content of the template changelog to the top of the actual changelog
    2. Create the changelog since the latest release (printed in console) with npm run createChangelog -- --sha <latest commit hash of previous release>
    3. Copy the changelog to the corresponding position in the template
    4. Create a TL;DR
  2. Update the version to server version mapping file
    1. See When to update

WebUI to server mapping

Explanation

For the server to be able to automatically download the latest compatible WebUI version, the version to server version mapping file has to be provided.

The order of the version mapping is important and has to be sorted by oldest WebUI version to latest version.
The latest version will always be PREVIEW.

When to update

  • changes get added that require a new minimum server version
    • update: the mapped server version for the PREVIEW version
  • releasing a new version
    • update: in case the minimum server version has
      • not changed: the latest WebUI version mapping that is not the PREVIEW version has to be updated
      • changed: add a new entry below the PREVIEW version with the mapped server version from PREVIEW

Coding Style Guide

Note: Some of the bellow are new, refactor the code to match the style guide where you see inconsistency.

  • Don't use relative imports.
  • We are using MUI v5, the all stylings must be applied with the new system.
  • Never use the style prop, there's always a cleaner solution with sx or styled.
  • Any new or changed string that might be shown to the user must be translated.