# KingJA/LoadSir

A lightweight, good expandability Android library used for displaying different pages like loading, error, empty, timeout or even your custom page when you load a page.(优雅地处理加载中，重试，无数据等)

Repository: https://github.com/KingJA/LoadSir
Canonical: https://ross.abutalabs.com/products/loadsir
Language: Java
License Family: other
Topics: loadsir, loadpage, progresspage, errorpage, emptypage, custompage
Last push: 2020-12-26T03:23:03+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3287, "days_push": 2076, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3471, forks 506 (observed 2026-08-28T04:08:06.002625+00:00)

## What it is
LoadSir is a lightweight, highly extensible Android library for managing load feedback pages, switching between loading, error, empty, timeout, and custom state views when data loads. It works with Activities, Fragments, and Views without modifying layout files, and supports automatic state switching based on network response codes.

## Use cases
- show loading spinner while fetching data in android
- display error page with retry button in android app
- show empty state when no data available
- handle network timeout page in android
- switch status pages based on api response codes
- custom placeholder pages in fragments and views

## When to choose
- you need flexible loading/error/empty state handling across Activities, Fragments, and Views
- you want state pages without modifying existing layout files
- you need custom state pages with per-page click handlers and global or per-screen configuration

## When to avoid
- you are not building an Android app
- you need a library with active maintenance and a clear license
- you prefer Jetpack Compose-based state handling over View-based approaches

## Facets
- artifact type: library
- maturity: maintenance
- function: ui-components, state-management
- domain: mobile-development, android-tools, frontend
- platform: jvm
- tags: loading-states, error-pages, empty-state, status-page-switching, android-ui, android, mobile

## Member repositories
- KingJA/LoadSir (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:06.002625+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:36:37.321662+00:00, confidence not recorded.
  - readme: https://github.com/KingJA/LoadSir (fetched 2026-08-28T04:08:06.002625+00:00, sha 044d266fa0b5)
- Data as of 2026-08-30T08:39:29.467469+00:00.