Competitive Splatoon Platform
- Full tournament system
- Automatic bracket progression
- Single Elimination, Double Elimination, Round Robin, Swiss
- Splatoon specific maplists (picked by the organizer or teams)
- Counterpicking of different styles
- Automatic seeding tool
- Ranked tournaments allowing users to climb the leaderboard
- View streams of tournament (both participants and the cast)
- Seasonal ladder system
- Join by yourself or with 1-3 of your mates, get a full group and challenge other teams
- View streams of ongoing matches
- Maplist generation based on given preferences
- Private notes
- Map planner that lets you draw on maps and insert weapons
- Map list generation tool
- Win badges from tournaments, management tools for TOs
- Calendar to find out upcoming events to play in
- Event result reporting
- Plus Server for top players "looking for group purposes" voting and suggestion tools.
- User pages
- User search
- "LFG", find make a post to find people to play with
- Form teams (featuring uploading profile and banner pictures)
- Object Damage Calculator (how much does each weapon deal vs. different objects)
- Build Analyzer (exact stats of your builds)
- Add and search for videos by weapon, stage, player and more
- Auth via Discord
- Light and dark mode
- Localization
- React
- Remix
- Sqlite3
- Bun
- CSS (plain)
- E2E tests via Playwright
- Unit/integration tests via bun:test
Prerequisites: nvm
There is a sequence of commands you need to run:
nvm use
to switch to the correct Node version. If you don't have the correct Node.js version yet it will prompt you to install it via thenvm install
command. If you have problems with nvm you can also install the latest LTS version of Node.js from their website.- Install latest version of Bun
bun install
to install the dependencies.- Make a copy of
.env.example
that's called.env
. Filling additional values is not necessary unless you want to use real Discord authentication or develop the Lohi bot. bun migrate up
to set up the database tables.bun run dev
to run the project in development mode.- Navigate to
http://localhost:5173/admin
. There press the seed button to fill the DB with test data. You can also impersonate any user (Sendou#0043 = admin).
See CONTRIBUTING.md for more information.
Empty DB with the latest migration run. When creating new migrations they should also be applied+committed to this file (add it in .env
and then run the migration command as normal).
sendou.ink can be translated into any language. All the translations can be found in the locales folder. Here is how you can contribute:
- Copy a
.json
file from/en
folder. - Translate lines one by one. For example
"country": "Country",
could become"country": "Maa",
. Keep the "key" on the left side of : unchanged. - Finally, send the translated .json to Sendou or make a pull request if you know how.
Things to note:
weapons.json
andgear.json
are auto-generated. Don't touch these.- If some language doesn't have a folder it can be added.
- Some translated
.json
files can also have some lines in English as new lines get added to the site. Those can then be translated. - Some lines have a dynamic part like this one:
"articleBy": "by {{author}}"
in this case{{author}}
should appear in the translated version unchanged. So in other words don't translate the part inside{{}}
. - There is one more special syntax to keep in mind. When you translate this line
"project": "Sendou.ink is a project by <2>Sendou</2> with help from contributors:",
the<2></2>
should appear in the translated version. The text inside these tags can change. - To update a translation file copy the existing file, do any modifications needed and send the updated one.
Any questions please ask Sendou!
- Take an existing article as a base: https://raw.githubusercontent.com/Sendouc/sendou.ink/rewrite/content/articles/in-the-zone-26-winners.md
- Copy and paste the contents to a text file
- First, edit the info section at the top:
- "title" = title of the page
- "date" = date when this article was written (format YYYY-MM-DD)
- "author" = your name as you want it shown on the website
- Write the actual article below the second
---
- You can use Markdown for more advanced formatting (read https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax for more info)
- Name the file as you want the URL to be. For example
in-the-zone-26-winners.md
becomeshttps://sendou.ink/a/in-the-zone-26-winners
- Send the file to Sendou (or open a pull request if you know how)
- Optional: also send an image as .png if you want to show a link preview. The preferred dimensions are 1200 × 630.
By default SQL is logged in truncated format. You can adjust this by changing the SQL_LOG
env var. Possible values are "trunc", "full" and "none".
Note it only logs queries made via Kysely.
If you want to use the API then please leave an issue explaining your use case. By default, I want to allow open use of the data on the site. It's just not recommended to use the same APIs the web pages use as they are not stable at all and can change at any time without warning.
sendou.ink/
├── app/
│ ├── components/ -- React components
│ ├── db/ -- Database layer
│ ├── hooks/ -- React hooks
│ ├── modules/ -- "nodu_modules but part of the app" https://twitter.com/ryanflorence/status/1535103735952658432
│ ├── routes/ -- Routes see: https://remix.run/docs/en/v1/guides/routing
│ ├── styles/ -- All .css files of the project for styling
│ ├── utils/ -- Random helper functions used in many places
│ └── permissions.ts / -- What actions are allowed. Separated by frontend and backend as frontend has constraints based on what user sees.
├── migrations/ -- Database migrations
├── public/ -- Images, built assets etc. static files to be served as is
└── scripts/ -- Stand-alone scripts to be run outside of the app
NOTE: public/static-assets
should only have files that don't change as it is cached for 1 month.
Feature folders contain all the code needed to make that feature happen. Some common folders include:
- routes (same principle as Remix file system routing)
- queries
- components
- core (all core logic, separated from any React details)
Some common files:
- styles.css
- feature-hooks.ts
- feature-utils.ts
- feature-constants.ts
- feature-schemas.server.ts
bun scripts/add-badge.ts fire_green "Octofin Eliteboard"
bun scripts/rename-badge.ts 10 "New 4v4 Sundaes"
bun scripts/add-badge-winners.ts 10 "750705955909664791,79237403620945920"
sips -s format png ./sundae.gif --out .
While in the folder with the images:
for i in *.png; do npx @squoosh/cli --avif '{"cqLevel":33,"cqAlphaLevel":-1,"denoiseLevel":0,"tileColsLog2":0,"tileRowsLog2":0,"speed":6,"subsample":1,"chromaDeltaQ":false,"sharpness":0,"tune":0}' $i; done
Note: it only works with Node 16.
Note: This is only useful if you have access to a production running on Render.com
- Access the "Shell" tab
cd /var/data
cp db.sqlite3 db-copy.sqlite3
wormhole send db-copy.sqlite3
- On the receiving computer use the command shown.
- Fill /scripts/dicts with new data from leanny repository:
- weapon = contents of
weapon
folder - langs = contents of
language
folder - Couple of others at the root:
GearInfoClothes.json
,GearInfoHead.json
,GearInfoShoes.json
,spl__DamageRateInfoConfig.pp__CombinationDataTableData.json
,SplPlayer.game__GameParameterTable.json
,WeaponInfoMain.json
,WeaponInfoSpecial.json
andWeaponInfoSub.json
- weapon = contents of
- Update
AVAILABLE_SR_GEAR
with new SR gear & new gear bought with scales - Update all
CURRENT_SEASON
constants - Update
CURRENT_PATCH
constants - Update
PATCHES
constant with the late patch + remove the oldest - Update the stage list in
stage-ids.ts
andcreate-misc-json.ts
. Add images from Lean's repository and avify them. bun scripts/create-misc-json.ts
bun scripts/create-gear-json.ts
bun scripts/create-analyzer-json.ts
8a. Double check that no hard-coded special damages changedbun scripts/create-object-dmg-json.ts
- Fill new weapon IDs by category to
weapon-ids.ts
(easy to take from the diff of English weapons.json) - Get gear IDs for each slot from /output folder and update
gear-ids.ts
. - Replace
object-dmg.json
with theobject-dmg.json
in /output folder - Replace
weapon-params.ts
with theparams.json
in /output folder - Delete all images inside
main-weapons
,main-weapons-outlined
,main-weapons-outlined-2
andgear
folders. - Replace with images from Lean's repository.
- Run the
bun scripts/replace-img-names.ts
command - Run the
bun scripts/replace-weapon-names.ts
command - Run the .avif generating command in each image folder.
- Update manually any languages that use English
gear.json
andweapons.json
files
If you change any files and the CI pipeline errors out on certain formatting/linting steps (Biome) run this command in the repo's root directory:
bun cf
Before committing, if for some reason you see an abnormally high amount of files changed, simply run git add --renormalize .
and it will fix the error.
- Background info: this is caused by the line endings on your local repo not matching those with the remote repos, which should remove the vast majority of unstaged files that appears to have no changes at all.
- Reference: https://docs.github.com/en/get-started/getting-started-with-git/configuring-git-to-handle-line-endings