steaL
Finds Steam sales, compares prices across stores, and tells you whether to buy now or wait.帮你找 Steam 折扣、跨商店比价,判断现在买还是再等。
It started as a SwiftUI iOS app and is growing into a monorepo: a native Android app, a shared Kotlin Multiplatform module and a serverless backend on AWS.最初是一个 SwiftUI iOS 应用,现在正扩展成一个 monorepo:原生安卓应用、Kotlin Multiplatform 共享模块,以及部署在 AWS 上的 Serverless 后端。






Hot deals across stores跨商店热门折扣
Prices, history and offers for each game每款游戏的价格、史低和各商店报价
AI says buy, wait or skip, and whyAI 给出买、等还是跳过,并说明理由
Sale calendar, fed by my AWS API促销日历,数据来自我的 AWS 后端
Wishlist synced with FirebaseFirebase 实时同步的愿望单
Region, currency, theme and alerts地区、货币、主题和提醒设置
steaL/JohnWes7/steaL on GitHubGitHub 上的 JohnWes7/steaL
The original app, in SwiftUI with Liquid Glass最早的版本,SwiftUI + Liquid Glass
steaL/Views/SwiftUI screens and componentsSwiftUI 页面和组件steaL/ViewModels/@Observable view models@Observable 视图模型steaL/Services/One client per API: IsThereAnyDeal, Steam, sale events, the LLM, Firebase每个接口一个客户端:IsThereAnyDeal、Steam、促销日历、LLM、FirebasesteaL/Models/Codable types for each API各接口的 Codable 数据模型
Prices, price history, trailers and reviews come from IsThereAnyDeal and the Steam Store API. Each part of a page loads on its own, so one slow request doesn't hold up the rest.价格、史低、预告片和评测来自 IsThereAnyDeal 和 Steam Store API。页面各部分独立加载,一个请求慢不会拖住整页。
The buy-or-wait advice works with any OpenAI-compatible provider, and the API key stays in the Keychain. There are price-drop and release alerts, Dynamic Type, VoiceOver, 7 regions, English and Chinese.买还是等的建议支持任意 OpenAI 兼容服务商,API Key 存在 Keychain。另有降价和发售提醒、Dynamic Type、VoiceOver、7 个地区、中英文。
For now it calls these services itself. They move into shared/ next.目前这些服务还是 iOS 自己调用,之后会移到 shared/。
SwiftUI / SwiftData / Swift Concurrency / TipKit / SwiftLint
The same app in Jetpack Compose and Material 3. The screens are still placeholders同一个应用的 Jetpack Compose + Material 3 版本,页面目前还是占位
…/navigation/Five tabs on Navigation 3, each with its own back stackNavigation 3 管理 5 个 tab,每个 tab 有自己的返回栈…/views/The five tab screens, placeholders for now5 个 tab 页面,目前是占位…/views/theme/Material 3 colours and typeMaterial 3 配色和字体
The same app, written again in Jetpack Compose and Material 3. The UI stays native on each platform. Only the logic underneath will be shared.同一个应用,用 Jetpack Compose 和 Material 3 重新写。界面在每个平台上都保持原生,只有底层逻辑会共用。
Tabs, navigation and theme are in place. The screens come next.Tab、导航和主题已经搭好,接下来做各个页面。
Kotlin / Jetpack Compose / Material 3 / Navigation 3 / Gradle
Kotlin Multiplatform with Ktor and Kermit. Android already uses it. iOS will once the services move in, starting with IsThereAnyDeal.Kotlin Multiplatform + Ktor + Kermit。Android 已经在用,iOS 等服务移进来后接入,第一个是 IsThereAnyDeal。
The sale calendar's API, in Python on AWS促销日历的后端接口,Python 编写,部署在 AWS
api/
openapi.yaml, the OpenAPI 3.1 contract for GET /v1/sale-eventsopenapi.yaml:GET /v1/sale-events 的 OpenAPI 3.1 契约
src/sale_events/The refresh logic, with no cloud SDK刷新逻辑,不依赖任何云 SDKfunctions/Two Lambdas: the weekly refresh, and GET /v1/sale-events两个 Lambda:每周刷新,以及 GET /v1/sale-eventsinfra/Terraform for API Gateway, Lambda, S3 and the schedulerTerraform 管理 API Gateway、Lambda、S3 和定时器tests/pytest on saved copies of real pages. No network, no AI, no real AWSpytest 跑在存下来的真实页面上,不联网、不调 AI、不碰真实 AWS
Every Monday it collects the store-wide sales for Steam, Epic, itch.io and GOG. DeepSeek only copies the names and dates out of each page. Code adds the times, converts to UTC and makes the IDs. Each name has to appear word for word on the page, so the AI can't make up a sale. If any check fails, the batch is thrown away and the last good data stays.每周一抓取 Steam、Epic、itch.io 和 GOG 的全站促销。DeepSeek 只负责从页面里抄出活动名和日期,时刻、UTC 换算和 id 都由代码处理。活动名必须在页面原文里逐字出现,AI 没法凭空编出一场促销。任何一项校验不通过,这次结果整份作废,保留上一份数据。
GOG has no schedule to read, so an agent searches the web and opens pages itself. Every sale it reports needs a source page and a quote, and code checks the quote is really on that page.GOG 没有可读的促销日程,所以交给一个 agent 自己搜索、打开网页。它报上来的每场促销都要附来源网页和原文引文,代码会核对引文确实出现在那一页。
Three files are AWS-specific. Moving clouds means swapping those and the Terraform.只有 3 个文件依赖 AWS,换云只需要替换它们和 Terraform。
Python / OpenAPI 3.1 / Lambda / S3 / EventBridge Scheduler / Terraform / pytest + moto
Outside the repo仓库之外
IsThereAnyDeal and the Steam Store API for prices, Firebase for accounts and the wishlist, any OpenAI-compatible LLM for adviceIsThereAnyDeal 和 Steam Store API 提供价格,Firebase 负责账号和愿望单,任意 OpenAI 兼容的 LLM 给出购买建议
Hatched parts are still being built斜纹部分还在开发中Open a folder to see what's inside点开文件夹看看里面