Zepp Explorer

Web-application that provides access to ZeppOS applications and watch face catalogue for all device models and most regions.

Features:

• Local database mirroring and icon cache for faster navigation;
• Application and firmware release history;
• Device benchmark results server.

Tech stack: Python, FastAPI, SQLAlchemy, TypeScript, React, BeerCSS.

Local deployment

With docker: docker compose up -d --build.

Without docker (requires Python3, PDM, Node.js, Just and more staff):

# 0. Start a postgres and redis servers manually, or use Docker (just startdb)

# 1. Configure application
cp ./docs/config.yml ./data/config/config.yml
vim ./data/config/config.yml # add at least one amazfit account to use content fetcher
cp ./.env.example ./.env
vim ./.env # at lest change SQL connection data

# 2. Install node dependencies and build UI
cd zeppexplorer_web
npm i
npm run build
cd ..

# 3. Fetch AppStore contents
pdm run python -m zeppexplorer.fetch
# Will take ~`4/account_count` hours, for single account ~4 hrs

# 4. Run backend and pray
just startback
# http://localhost:8000

# Optional: run UI in development mode in new terminal
just startui
# http://localhost:5173