Heapy/awesome-kotlin
39.5
Weak · 14 November 2026
18.2k
lines of production code
Kotlin
primary language
5
measurements over time
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
Add list component for rendering subcategory links
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
Introduce Listitem component for displaying resource links
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
New navigation bar component with external link support
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
Automated Kotlin User Group link generation
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
Enhanced link metadata and platform tagging
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
New configuration model and DTOs for link data representation
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.