Skip to content

Repository files navigation

Uplist

The open-source, self-hostable App Store Optimization platform.

Track keywords, analyze competitors, and optimize your app store listings — on your own infrastructure, with no per-seat pricing and nothing hidden.

License: AGPL v3 PRs Welcome Status

Website · Documentation · Roadmap · Contributing


What is Uplist?

Uplist is an open-source alternative to closed ASO suites like AppTweak, App Radar, and Sensor Tower. It helps you get your app found in the App Store, Google Play, and the Mac App Store — by tracking where you rank, showing what your competitors are doing, and helping you write listings that convert.

The difference: you host it, you own the data, and it's free. No seat limits, no locked features behind an enterprise tier, no sending your keyword strategy to someone else's cloud.

Status: Uplist is in early alpha. The architecture and roadmap below are the plan we're building toward. Star the repo to follow along, and see Contributing if you want to help shape it.

Features

  • Keyword research & rank tracking — discover keywords, track daily positions over time across App Store, Google Play, and Mac App Store.
  • Competitor analysis — watch competitor listings, keywords, categories, and rank movements.
  • Metadata optimization — score and improve your title, subtitle, keyword field, and description, with AI-assisted suggestions.
  • Localization management — manage listings across every locale from one place.
  • Review & sentiment monitoring — track ratings and reviews, surface themes and regressions.
  • Creative A/B tracking — keep a history of icon, screenshot, and preview changes against conversion.
  • Conversion insights — connect App Store Connect and Google Play Console to correlate ASO changes with real installs.

Quickstart (self-host with Docker)

git clone https://github.com/halidsaglam/uplist.git
cd uplist
cp .env.example .env      # fill in your secrets and store API credentials
docker compose up -d      # starts Uplist + PostgreSQL

Then open http://localhost:3000 and create your admin account.

See docs/SELF_HOSTING.md for production deployment, backups, and configuration.

Tech stack

  • App: Next.js (App Router) + TypeScript
  • UI: Tailwind CSS + shadcn/ui
  • Database: PostgreSQL with Drizzle ORM
  • Jobs: scheduled workers for rank crawling and store syncs
  • Deploy: single Docker Compose stack for self-hosting

See docs/ARCHITECTURE.md for the full design.

Roadmap

  • v0.1 — Foundations: project scaffold, auth, app onboarding (add an app by store URL)
  • v0.2 — Rank tracking: keyword lists, rank snapshots with trend + sparkline, and a scheduled crawler (App Store + Google Play)
  • v0.3 — Competitors: competitor tracking and side-by-side keyword comparison
  • v0.4 — Metadata studio: store-aware listing editor with a live ASO score, rule-based suggestions, tracked-keyword coverage, and optional AI suggestions (any OpenAI-compatible provider)
  • v0.5 — Reviews: App Store review sync with rating distribution and sentiment coloring (Google Play to follow)
  • v0.6 — Connect: App Store Connect & Google Play Console integrations for install data
  • v1.0 — Localization, creative A/B history, and a polished dashboard

Contributing

Uplist is built in the open and contributions are very welcome — code, docs, design, or just good issues. Start with CONTRIBUTING.md.

License

Uplist is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

In short: you can use, modify, and self-host Uplist freely. If you run a modified version as a network service, you must make your source available under the same license. This keeps Uplist open for everyone and prevents closed-source SaaS forks.

About

The open-source, self-hostable App Store Optimization platform. Track keywords, analyze competitors, and optimize your App Store & Google Play listings.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages