Ecosystem

Toolchain

Standard Ranklist

Repository: algoux/standard-ranklist

This is the srk core. It includes:

• Specification documents
• TypeScript type definitions
• JSON Schema

For developers, it can be used to:

1. Import type declarations for building tools and applications in TypeScript:

npm install -D @algoux/standard-ranklist

import type * as srk from '@algoux/standard-ranklist';

const myRanklist: srk.Ranklist = { ... };

2. Use the JSON Schema for autocompletion and validation in JSON files, or integrate with other validation tools:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://unpkg.com/@algoux/standard-ranklist@latest/schema.json",
  "contest": { ... },
  "problems": [ ... ],
  "series": [ ... ],
  "rows": [ ... ]
}

Renderer Component

Repository: algoux/standard-ranklist-renderer-component

A set of web rendering component packages for srk ranklists, available for React, Vue, Angular, Solid, and Svelte.

It has been used in:

• Multiple past editions of the CCPC official ranklist pages
• RankLand

→ See Renderer Component

CLI

Repository: algoux/standard-ranklist-cli

The srk command-line tool provides commands such as validate, diagnose, patch, convert, preview, and render. It is useful for validating srk files locally or in CI, checking common data issues, generating fix patches, exporting other platform formats, previewing ranklists, rendering static pages, and similar workflows.

→ See CLI Tool

Utils

Repository: algoux/standard-ranklist-utils

A utility library for srk that provides common data processing functions, with packages for JavaScript/TypeScript, Python, and Go:

• Data validation
• Sorting and computation
• Bidirectional conversion between static ranklists and submission record lists
• Other utility functions

→ See Utils Library

Convert-to

Repository: algoux/standard-ranklist-convert-to

A format conversion tool that converts srk data into formats used by other platforms and tools, including:

• Codeforces Gym format
• Excel spreadsheets
• Virtual Judge Replay format

→ See Format Conversion

Typical Workflows

For developers, many scenarios are well-suited for the srk ecosystem, such as:

1. Production — Enhance your OJ, tools, or services by using native or converted srk data
2. Rendering — Use the Renderer component to display ranklists in your own applications
3. Checking and Previewing — Use the CLI to validate, diagnose, convert, preview, and render srk files locally or in CI
4. Analysis — Use Utils and Convert-to tools to extract and batch-process ranklist data

Platform

RankLand

URL: https://rl.algoux.cn/

RankLand is a data distribution platform built on srk. You can easily:

• Browse officially maintained and community-contributed contest ranklist data from past years
• Debug srk data online via the Playground
• Connect your managed contests to receive stable, reliable live external ranklist distribution and data archiving services Beta
• Use the Kessoku Series suite to provide live broadcast directing capabilities for your contests, greatly enriching the competition experience Beta