Skip to content
CAI
Software that uses CAICheck a score

Heapy/awesome-kotlin

39.5

Weak · 14 November 2026

18.2k

lines of production code

Kotlin

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add GitHub-themed syntax highlighting for code blocks

The application now supports syntax highlighting for code snippets using highlight.js v11.9.0, styled with the official GitHub light theme. This ensures that code blocks rendered in article pages are visually consistent with GitHub's interface, improving readability for technical content.

app-frontend/pages · high confidence

Introduced a new \Subcategories\ component that displays links within a subcategory, grouped by their state (Awesome, Default, Archived, Unsupported) and sorted by star count. The component generates anchor links for section navigation and applies responsive styling to adjust the list width based on screen size.

app-frontend/app/src/components/list · high confidence

Added local database schema generation and migration script

A new Kotlin script (Generate.kt) has been added to the app-backend-dataops module to automate local database setup. This script drops and recreates the public schema, runs Flyway migrations from a specific filesystem path, and generates JOOQ Kotlin data classes and DAOs from the PostgreSQL database.

app-backend-dataops · high confidence

Dynamic header logo with time-based and exclusive variants

The site header now displays a rotating set of logos, including standard Kotlin branding and special variants for events like the 10K anniversary, Star Wars Day, and the Ukraine support initiative. The \logos.ts\ module manages these assets, using date-based logic to show specific logos exclusively during certain periods or on specific dates. The \Header\ component cycles through the available logos, ensuring that if an exclusive logo is active, it is displayed alone, while other logos rotate in a sequence when no exclusive variant is currently scheduled.

app-frontend/app/src/components/head · high confidence

Implement GitHub OAuth and user authentication endpoints

The backend now exposes new API endpoints for user registration, login, and GitHub OAuth integration. Users can register via POST /register, which stores credentials using BCrypt hashing, and log in via POST /login, which issues an HTTP-only JWT cookie. Additionally, GitHub OAuth is supported through GET /auth/github/redirect to initiate the flow and GET /auth/github to handle the callback and exchange the authorization code for an access token.

app-backend/src/main/kotlin/usecases/github, app-backend/src/main/kotlin/usecases/signup · high confidence

Initial frontend application structure and routing setup

The frontend application source code has been organized into a new \app/src\ directory, establishing the core structure for the user interface. This includes a React 17 entry point (\main.tsx\) utilizing \createRoot\ and \React.StrictMode\, a routing configuration (\root.tsx\) defining paths for Home, KUGs, Resources, and Articles, and a data model (\model.tsx\) that categorizes links by platform and state (including AWESOME, UNSUPPORTED, ARCHIVED, and DEFAULT). Supporting files provide TypeScript declarations for static assets, utility functions for link sorting and query string generation, and LESS stylesheets defining the visual theme and responsive breakpoints.

app-frontend/app/src · high confidence

Initial release of the curated Kotlin resources directory

The \src/main/resources/links\ directory has been introduced to serve as the central, structured data source for the project's curated list of Kotlin resources. This change replaces the previous flat or unstructured approach with a set of categorized Kotlin Script (\.kts\) files—specifically \Android\, \Archive\, \JavaScript\, \Libraries\, \Links\, \Native\, \Projects\, \UserGroups\, and \WebAssembly\. These files define the official links, libraries, frameworks, and community groups available to users, organized by platform and category (e.g., separating Android libraries from Web frameworks, or isolating archived projects). This structure enables the generation of the main \README.md\ and other documentation pages with a consistent, maintainable format.

src/main/resources/links · high confidence

A new Listitem component has been added to render individual resource entries in the list view. It displays the link name, description (rendered as HTML), star count, and last update date. The component visually distinguishes links based on their state: archived and unsupported links are dimmed, while unsupported links also include an '\[unsupported\]' prefix in the title. Links are styled with specific colors and hover effects, and the description section is hidden if empty.

app-frontend/app/src/components/listitem · high confidence

Introduce dedicated page for browsing all resources

A new \LinksPageComponent\ has been added to render a comprehensive view of all available resources. This page includes a navigation bar with links to 'Essential', 'Everything', and 'Kotlin User Groups', along with a search feature that filters resources by name, description, and tags. This change supports the ability to view the full list of resources rather than just starred items.

_app-frontend/app/src/components/page\wrapper · high confidence

Introduces new utility classes for caching, HTTP, and file operations

The \src/main/kotlin/link/kotlin/scripts/utils\ package now includes several new utility components: \Cache.kt\ provides a file-based caching implementation with a disable wrapper, \HttpClient.kt\ wraps Apache's async HTTP client for suspendable requests, \Fs.kt\ and \CopyTask.kt\ add file writing and resource copying helpers, \KotlinObjectMapper.kt\ configures Jackson for Kotlin, and \Utils.kt\ adds logging proxies and time parsing. These changes enhance the internal tooling capabilities for script execution and data handling.

src/main/kotlin/link/kotlin/scripts/utils · high confidence

New Category component for displaying subcategories

A new Category component has been added to the frontend, which renders a section containing a category title and a list of its subcategories. This component utilizes a new LESS stylesheet to style the category container with alternating background colors and borders, and it imports the existing Subcategories component to render the individual items within the category wrapper.

app-frontend/app/src/components/category · high confidence

New dedicated pages for Home, Resources, Kugs, and Articles

The application now includes distinct pages for Home, Resources, Kugs, and Articles. The Home page displays a curated list of 'awesome' links with a search option for all links. The Resources page shows all available links. The Kugs page displays links specific to the 'kugs' category. The Articles page is a placeholder indicating that articles will be available in the future.

app-frontend/app/src/pages · high confidence

A new Navigation component has been added to the application, rendering a horizontal bar of links separated by pipe characters. It distinguishes between internal and external links: internal routes use React Router's NavLink for active state styling (underline), while external HTTPS links open in a new tab with security attributes (noopener noreferrer). The layout is responsive, wrapping on smaller screens, and centers content within a maximum width of 1024px.

app-frontend/app/src/components/navigation · high confidence

New search component with custom styling and input behavior

A new Search component has been added to the application, featuring a custom LESS stylesheet that defines a bordered input field with a background search icon and specific focus styles (removing the default outline). The component includes an SVG icon asset and implements logic to sync the input value with the URL query parameter 'q' using React Router's navigation, while also handling keyboard events to prevent default behavior on non-Enter keys.

app-frontend/app/src/components/search · high confidence

Repository restructured with backend application and CI/CD infrastructure

The project has been reorganized from a static curated list into a full-stack web application. A new backend (Ktor) and frontend (React) architecture is introduced, supported by Docker and docker-compose files for local development and deployment. The repository now includes a GitHub Actions workflow for automated builds, an Apache 2.0 license, and standardized editor configurations, while the README has been updated to reflect the new site at kotlin.link and the contribution process.

(repo-wide) · high confidence

Behavioural changes

The import script now includes a new \Communities.kt\ utility that parses a local Markdown file of Kotlin User Groups and automatically generates the structured \UserGroups.awesome.kts\ link file, replacing the previous manual maintenance of this list.

src/main/kotlin/link/kotlin/scripts/import · high confidence

Backend server migration to Ktor with virtual thread support

The app-backend has been refactored to use the Ktor framework instead of the previous server implementation, introducing a new modular architecture for dependency injection and lifecycle management. This change enables the use of Kotlin virtual threads (Dispatchers.Loom) for improved concurrency and performance. The new server module wires up authentication (JWT), user registration and login routes, GitHub OAuth redirects, and static file serving for the React frontend. Additionally, the diff includes updated jOOQ-generated classes for the database schema and configuration modules for JDBC, metrics (Prometheus), and HTTP clients.

app-backend · high confidence

The link processing system now enriches repository entries with GitHub topics fetched from the API, adds an \archived\ status to identify outdated or inaccessible links, and allows links to be tagged with specific platforms (Android, iOS, JVM, etc.) via the DSL. Additionally, link descriptions are rendered as Markdown for better formatting.

repository · high confidence

Introduce dependency injection for script modules

The script generation pipeline now uses the komok-tech dependency injection library to manage component lifecycles. New module classes (ApplicationModule, ArticlesModule, LinksModule, RenderingModule, ScriptingModule, SiteModule, UtilsModule, ConfigurationModule) define and wire dependencies such as the markdown renderer, HTTP client, cache, and various processors, replacing the previous manual instantiation approach.

src/main/kotlin/link/kotlin/scripts/module · high confidence

Introduces Kotlin scripting with local file caching

The scripting module now uses Kotlin Scripting to execute \.awesome.kts\ files via a new \AwesomeScript\ definition and \ScriptEvaluator\ implementation. To improve build performance, script evaluation results are now stored in a local file cache, meaning repeated executions of the same script source will be served from cache rather than recompiled.

src/main/kotlin/link/kotlin/scripts/scripting · high confidence

Migrate articles to new model package

The article definition files in the \articles\ directory have been updated to use the \link.kotlin.scripts.dsl\ package for their data model. This change standardizes how article metadata (such as title, URL, categories, and author) is structured in the source files, ensuring consistency across the content library.

articles · high confidence

The application now uses a dedicated \ApplicationConfiguration\ interface and \DataApplicationConfiguration\ data class to manage settings such as GitHub tokens, site URLs, cache enablement, and dry-run modes, sourced from environment variables. Additionally, new Data Transfer Objects (DTOs) including \LinkDto\, \CategoryDto\, and \SubcategoryDto\ have been introduced to structure link data for the frontend, mapping internal link states (Awesome, Unsupported, Archived, Default) and organizing content into categories and subcategories.

src/main/kotlin/link/kotlin/scripts/model · high confidence

New frontend entry point with updated GitHub links

The application now uses a new \index.html\ file in the \app-frontend/app\ directory as its main entry point. This file establishes the basic HTML structure, including viewport settings, Open Sans font styling, and multiple favicon variants for various browsers and devices. It also defines the root div for the JavaScript application and provides a fallback message for users with JavaScript disabled, which now correctly links to the project's GitHub repository at \https://github.com/Heapy/awesome-kotlin\.

app-frontend/app · high confidence

Rewritten Kotlin scripts for site generation with new architecture

The site generation scripts in src/main/kotlin/link/kotlin/scripts have been completely rewritten to use a new modular architecture. This includes a new entry point (Application.kt) using dependency injection, separate sources for links and articles (FileSystemLinksSource, FileSystemArticlesSource), and processors for categories and articles. The system now supports fetching GitHub Trending data, processing articles with markdown rendering, and generating various site resources including JSON files, RSS feeds, sitemaps, and individual article pages. It also introduces a new caching mechanism for trending data and a noop links checker.

src/main/kotlin/link/kotlin/scripts · high confidence

Test coverage

Added manual test for Kotlin version fetching and unit test for date parsing; Added tests for KUG download service.

Dependencies

Initial dependency configuration for backend and frontend modules

The project now defines its dependency structure through a centralized version catalog (\gradle/libs.versions.toml\) and dedicated build files for the backend (\app-backend\, \app-backend-dataops\) and frontend (\app-frontend\). The backend is configured with Kotlin 2.4.20, Ktor 3.6.0, jOOQ 3.21.8, Flyway 13.7.0, and a custom \komok-tech\ dependency injection library, while the frontend utilizes React 19.3.0, Webpack 5.111.1, and Yarn 4.13.0.

(dependencies) · high confidence

Upgrade Gradle wrapper to version 9.7.1

The project's Gradle wrapper has been updated to use Gradle 9.7.1. This change ensures that builds are executed with the specified distribution, including a verified SHA-256 checksum for integrity, and configures the wrapper to download and store the distribution in the user's home directory.

gradle · high confidence

Upgrade to Yarn 4.13.0

The frontend build tooling has been upgraded to Yarn 4.13.0. This change updates the Yarn binary and adjusts the \.gitignore\ rules to accommodate Yarn 2+ conventions, ensuring that the \.yarn\ directory (except for cache, patches, plugins, releases, sdks, and versions) is ignored while the specific release binary is tracked.

app-frontend · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 39 → 40 (+0.2)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 78 → 77 (-0.1)
  • Architecture 95 → 94 (-0.6)
  • Maturity 43 → 43 (+0.0)
  • Readiness 33 → 33 (-0.5)
  • Security 35 → 36 (+0.7)
  • Accessibility 38 → 41 (+2.5)
  • Performance 100 → 100 (+0.0)

Resolved (66)

  • Duplicated block (5 lines × 2) (app-backend/src/main/kotlin/usecases/version/KotlinVersionFetcher.kt)
  • High CVE: [GHSA redacted] (app-frontend/yarn.lock)
  • Low CVE: [GHSA redacted] (app-frontend/yarn.lock)
  • Medium CVE: [GHSA redacted] (app-frontend/yarn.lock)
  • Medium CVE: [GHSA redacted] (app-frontend/yarn.lock)
  • Medium CVE: [GHSA redacted] (app-frontend/yarn.lock)
  • No ADRs found
  • Off-boarding risk: anonymized user #1
  • Outdated (compile): at.favre.lib:bytes
  • Outdated (compile): ch.qos.logback:logback-classic
  • Outdated (compile): ch.qos.logback:logback-core
  • Outdated (compile): com.auth0:java-jwt
  • Outdated (compile): com.fasterxml.jackson.core:jackson-core
  • Outdated (compile): com.fasterxml.jackson.core:jackson-databind
  • Outdated (compile): com.fasterxml.jackson:jackson-bom
  • Outdated (compile): com.fasterxml.woodstox:woodstox-core
  • Outdated (compile): com.google.errorprone:error_prone_annotations
  • Outdated (compile): com.google.guava:guava
  • Outdated (compile): com.squareup.okio:okio
  • Outdated (compile): com.squareup.okio:okio-jvm
  • …and 46 more

New (6)

  • Dependency hygiene PARTLY measured — Maven/Gradle declarations read, no dependency graph resolved
  • Duplicated block (5 lines × 2) (app-backend/src/main/kotlin/usecases/version/KotlinVersionFetcher.kt)
  • Edited copy of a member (11 corresponding lines) (app-backend/src/main/kotlin/usecases/signup/Register.kt)
  • Edited copy of a member (19 corresponding lines) (src/main/kotlin/link/kotlin/scripts/LinksProcessor.kt)
  • No ADRs found (build.gradle.kts)
  • Off-boarding risk: anonymized user #1

Changes since last survey

  • 38 commits — 38 feature/other, 0 fixes

By area

  • src/main — 29 commits
  • app-frontend/yarn.lock — 5 commits
  • app-frontend/package.json — 2 commits
  • gradle/libs.versions.toml — 2 commits

Notable commits

  • change: Add Aspectify to Libraries/Misc (#1208)
  • change: Add Aster-Android to Android projects (#1201)
  • change: Add Baton (#1189)
  • change: Add CMPDevicePreview to Libraries/Jetpack Compose (#1221)
  • change: Add CashPilot-android to Android projects (#1198)
  • change: Add Coddy Kotlin Course to Courses (#1213)
  • change: Add Composables.com and Compose Unstyled from PR #1108 (#1236)
  • change: Add Cratis/Chronicle.Kotlin to Libraries/Frameworks > Database (#1186)
  • change: Add DateParser Kotlin to the library catalogue (#1204)
  • change: Add Duet to Libraries/Frameworks > Multiplatform (#1206)
  • change: Add Easemic to Android Projects (#1212)
  • change: Add ForgeOps Tracker to Libraries/Frameworks > Logging (#1222)
  • change: Add Jev for WhatsApp to Android projects (#1199)
  • change: Add Joyframe to Libraries/Game Development (#1177)
  • change: Add Ketch download manager library (#1187)
  • change: Add Kuicksilver (QUIC and HTTP/3 for Kotlin Multiplatform) (#1215)
  • change: Add Mockzilla to Libraries/Multiplatform (#1219)
  • change: Add Proctor to Testing (#1225)
  • change: Add Stipple to Jetpack-Compose (#1224)
  • change: Add Telar to Libraries/Frameworks > Multiplatform (#1200)
  • …and 18 more

Architecture

  • Unchanged — 0 containers · 2 contexts · 0 edges

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

Heapy/awesome-kotlin was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit 685390daa2a0d667abaa12e2e140b9704cecc2b0 — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-e1a3b69fc8ee.