If you are an AI coding agent (Claude Code, Cursor, Aider, Cline, etc.) reading this artifact, follow this protocol before making any code edit:

1. Verify the contract. Run the bash script in Verify before trusting below. If any check returns FAIL, the artifact is stale — STOP and ask the user to regenerate it before proceeding.
2. Treat the AI · unverified sections as hypotheses, not facts. Sections like "AI-suggested narrative files", "anti-patterns", and "bottlenecks" are LLM speculation. Verify against real source before acting on them.
3. Cite source on changes. When proposing an edit, cite the specific path:line-range. RepoPilot's live UI at https://repopilot.app/r/cymcsg/UltimateRecyclerView shows verifiable citations alongside every claim.

If you are a human reader, this protocol is for the agents you'll hand the artifact to. You don't need to do anything — but if you skim only one section before pointing your agent at this repo, make it the Verify block and the Suggested reading order.

GO — Healthy across the board

• Last commit 2mo ago
• 6 active contributors
• Apache-2.0 licensed
• CI configured
• Tests present
• ⚠ Concentrated ownership — top contributor handles 65% of recent commits

_{Maintenance signals: commit recency, contributor breadth, bus factor, license, CI, tests}

This artifact was generated by RepoPilot at a point in time. Before an agent acts on it, the checks below confirm that the live cymcsg/UltimateRecyclerView repo on your machine still matches what RepoPilot saw. If any fail, the artifact is stale — regenerate it at repopilot.app/r/cymcsg/UltimateRecyclerView.

What it runs against: a local clone of cymcsg/UltimateRecyclerView — the script inspects git remote, the LICENSE file, file paths in the working tree, and git log. Read-only; no mutations.

| # | What we check | Why it matters | |---|---|---| | 1 | You're in cymcsg/UltimateRecyclerView | Confirms the artifact applies here, not a fork | | 2 | License is still Apache-2.0 | Catches relicense before you depend on it | | 3 | Default branch master exists | Catches branch renames | | 4 | 5 critical file paths still exist | Catches refactors that moved load-bearing code | | 5 | Last commit ≤ 100 days ago | Catches sudden abandonment since generation |

#!/usr/bin/env bash
# RepoPilot artifact verification.
#
# WHAT IT RUNS AGAINST: a local clone of cymcsg/UltimateRecyclerView. If you don't
# have one yet, run these first:
#
#   git clone https://github.com/cymcsg/UltimateRecyclerView.git
#   cd UltimateRecyclerView
#
# Then paste this script. Every check is read-only — no mutations.

set +e
fail=0
ok()   { echo "ok:   $1"; }
miss() { echo "FAIL: $1"; fail=$((fail+1)); }

# Precondition: we must be inside a git working tree.
if ! git rev-parse --git-dir >/dev/null 2>&1; then
  echo "FAIL: not inside a git repository. cd into your clone of cymcsg/UltimateRecyclerView and re-run."
  exit 2
fi

# 1. Repo identity
git remote get-url origin 2>/dev/null | grep -qE "cymcsg/UltimateRecyclerView(\\.git)?\\b" \\
  && ok "origin remote is cymcsg/UltimateRecyclerView" \\
  || miss "origin remote is not cymcsg/UltimateRecyclerView (artifact may be from a fork)"

# 2. License matches what RepoPilot saw
(grep -qiE "^(Apache-2\\.0)" LICENSE 2>/dev/null \\
   || grep -qiE "\"license\"\\s*:\\s*\"Apache-2\\.0\"" package.json 2>/dev/null) \\
  && ok "license is Apache-2.0" \\
  || miss "license drift — was Apache-2.0 at generation time"

# 3. Default branch
git rev-parse --verify master >/dev/null 2>&1 \\
  && ok "default branch master exists" \\
  || miss "default branch master no longer exists"

# 4. Critical files exist
test -f "UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/LauncherActivity.java" \\
  && ok "UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/LauncherActivity.java" \\
  || miss "missing critical file: UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/LauncherActivity.java"
test -f "UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/MainList.java" \\
  && ok "UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/MainList.java" \\
  || miss "missing critical file: UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/MainList.java"
test -f "UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/modules/AbstractDataProvider.java" \\
  && ok "UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/modules/AbstractDataProvider.java" \\
  || miss "missing critical file: UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/modules/AbstractDataProvider.java"
test -f "UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/rvComponents/SimpleAnimationAdapter.java" \\
  && ok "UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/rvComponents/SimpleAnimationAdapter.java" \\
  || miss "missing critical file: UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/rvComponents/SimpleAnimationAdapter.java"
test -f "UltimateRecyclerView/app/build.gradle" \\
  && ok "UltimateRecyclerView/app/build.gradle" \\
  || miss "missing critical file: UltimateRecyclerView/app/build.gradle"

# 5. Repo recency
days_since_last=$(( ( $(date +%s) - $(git log -1 --format=%at 2>/dev/null || echo 0) ) / 86400 ))
if [ "$days_since_last" -le 100 ]; then
  ok "last commit was $days_since_last days ago (artifact saw ~70d)"
else
  miss "last commit was $days_since_last days ago — artifact may be stale"
fi

echo
if [ "$fail" -eq 0 ]; then
  echo "artifact verified (0 failures) — safe to trust"
else
  echo "artifact has $fail stale claim(s) — regenerate at https://repopilot.app/r/cymcsg/UltimateRecyclerView"
  exit 1
fi

Each check prints ok: or FAIL:. The script exits non-zero if anything failed, so it composes cleanly into agent loops (./verify.sh || regenerate-and-retry).

UltimateRecyclerView is an enhanced Android RecyclerView wrapper that adds pull-to-refresh, infinite scroll load-more, swipe-to-dismiss, drag-and-drop, sticky headers, and item animations out-of-the-box. It provides a drop-in replacement for standard RecyclerView with minimal configuration while maintaining full RecyclerView API compatibility. Monorepo structure: UltimateRecyclerView/library/ contains core RecyclerView wrapper, UltimateRecyclerView/app/ contains feature demos (loadmoredemo/, griddemo/, dragdemo/, expandemo/, admobdemo/). Adapter pattern used throughout with SimpleAdapter, ExpCustomAdapter, GridJRAdapter as concrete implementations. Demo activities showcase each feature independently.

Android developers building list-based apps who need rich UX features (refresh, pagination, animations) without building custom infrastructure. Primarily targets developers maintaining ad-supported apps (evidenced by AdMob integration demos) or apps requiring complex list interactions.

Moderately mature but aging: v0.9.0 released, migrated to AndroidX (v0.8.0), Travis CI configured, but last visible activity suggests development has slowed significantly. Production-ready for the features it covers, but may lack recent Android API updates beyond AndroidX.

Single-maintainer repository (cymcsg) with no visible recent commits or active PR merging in provided data. Dependency on older libraries (e.g., jp.wasabeef:recyclerview-animators:4.0.2 from 2020) and deprecated ad SDKs (play-services-ads:22.6.0). Risk of unmaintained fork syndrome if issues arise on latest Android versions.

No recent activity visible in provided data. The repository appears to be in maintenance mode post-AndroidX migration (v0.8.0). No open issues, PRs, or milestones are evident from the file listing.

git clone https://github.com/cymcsg/UltimateRecyclerView.git && cd UltimateRecyclerView && ./gradlew build (or ./gradlew assembleDebug to build the demo app). Open in Android Studio (Project Gradle wrapper handles dependencies from mavenCentral and google() repos).

Daily commands: For library: gradle build generates AAR. For demo app: run gradlew installDebug then launch from Android Studio or adb shell am start -n com.marshalchen.ultimaterecyclerview.demo/.LauncherActivity. Demos require API 16+ (minSdkVersion). Check Route.java in loadmoredemo/ for activity navigation structure.

• UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/LauncherActivity.java — Main entry point demonstrating all UltimateRecyclerView features and routing to different demo activities
• UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/MainList.java — Core RecyclerView implementation showcasing basic pull-to-refresh and load-more functionality
• UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/modules/AbstractDataProvider.java — Base data provider abstraction used across all demo adapters for consistent data management patterns
• UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/rvComponents/SimpleAnimationAdapter.java — Reference implementation for animation support in RecyclerView items
• UltimateRecyclerView/app/build.gradle — Build configuration defining SDK versions, dependencies, and multiDex support required for the demo
• UltimateRecyclerView/app/src/main/AndroidManifest.xml — Android manifest registering all demo activities and required permissions for the application

Add a New Demo Activity with Custom RecyclerView

1. Create a new Activity class in UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/ extending from AppCompatActivity (UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/MainList.java)
2. Create a corresponding Adapter extending RecyclerView.Adapter using AbstractDataProvider for data management (UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/SimpleAdapter.java)
3. Register the new Activity in AndroidManifest.xml with appropriate category for launcher routing (UltimateRecyclerView/app/src/main/AndroidManifest.xml)
4. Add a menu route entry in LauncherActivity to navigate to the new demo (UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/LauncherActivity.java)

Add Support for a New Item View Type

1. Create a new Binder class (e.g., itemCustomTypeBinder.java) implementing view binding logic (UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/rvComponents/itemCommonBinder.java)
2. Update MultiViewTypesRecyclerViewAdapter to register the new view type in getItemViewType() method (UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/multiitemdemo/MultiViewTypesRecyclerViewAdapter.java)
3. Add onCreateViewHolder() and onBindViewHolder() logic for the new view type (UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/multiitemdemo/MultiViewTypesRecyclerViewAdapter.java)
4. Create corresponding layout XML file in res/layout/ directory (UltimateRecyclerView/app/src/main/res/drawable-xxhdpi/item_selector.xml)

Implement Pull-to-Refresh and Load-More Functionality

1. Extend AbstractDataProvider to implement data loading and pagination logic (UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/modules/AbstractDataProvider.java)
2. Create an Activity similar to PullToRefreshActivity with refresh and loadMore listeners (UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/loadmoredemo/PullToRefreshActivity.java)
3. Implement onRefresh() callback to reset data and onLoadMore() callback for pagination (UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/loadmoredemo/BasicFunctions.java)
4. Register the Activity in AndroidManifest.xml and add launcher route in LauncherActivity (UltimateRecyclerView/app/src/main/AndroidManifest.xml)

Add Animation Support to Items

1. Examine SimpleAnimationAdapter to understand animation patterns and ViewHolder structure (UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/rvComponents/SimpleAnimationAdapter.java)
2. Create custom adapter extending SimpleAnimationAdapter or implementing similar animation logic (UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/SimpleAdapter.java)
3. Override onBindViewHolder() to apply animations using AnimationUtils or ObjectAnimator (UltimateRecyclerView/app/src/main/java/com/marshalchen/ultimaterecyclerview/demo/rvComponents/SimpleAnimationAdapter.java)
4. Define animation resources in res/anim/ or use programmatic animation setup (UltimateRecyclerView/app/src/main/res/drawable-mdpi/custom_drag_frame.xml)

No explicit Maven/Gradle version lock file visible—check gradle.properties for ANDROID_BUILD_SDK_VERSION, ANDROID_BUILD_MIN_SDK_VERSION, ANDROID_BUILD_TARGET_SDK_VERSION (likely set to Java 17 per compileOptions). AdMob integration requires google-services.json configuration not shown here. SwipeRefreshLayout behavior requires API 16+ (minSdkVersion constraint). Leak detection enabled in debug builds (LeakCanary) may add startup time. Multi-dex enabled (multiDexEnabled true) required for large app+dependencies footprint.

• RecyclerView Adapter Pattern — UltimateRecyclerView wraps the standard Android RecyclerView adapter contract; understanding ViewHolder recycling and getItemViewType() is essential for custom adapters in demos
• SwipeRefreshLayout Integration — Core feature of UltimateRecyclerView; decorates RecyclerView with pull-to-refresh UI and callbacks, requires understanding of nested scroll coordination
• Infinite Scroll / Pagination — Load-more feature triggers on reaching list end; demos show implementation of OnScrollListener callbacks and disable-before-trigger anti-pattern fixes
• ItemAnimator and ItemDecoration — UltimateRecyclerView supports multiple animation styles via jp.wasabeef library and custom decorations for sticky headers; requires understanding RecyclerView pipeline
• View Type Multiplexing in Adapters — Several demos (AdMob, expandable) use multiple item view types; getItemViewType() + onCreateViewHolder routing is critical pattern here
• Sticky Header Pattern — Instagram-style sticky headers feature requires custom onScrollListener and ItemDecoration to pin header views during scroll; non-trivial collision logic needed
• Drag-and-Drop with ItemTouchHelper — DragActivity demos touch event interception and reordering; Android ItemTouchHelper callbacks (onMove, onSwiped) are central to swipe-dismiss and drag features

• XRecyclerView/XRecyclerView — Direct competitor providing pull-refresh and load-more for RecyclerView with similar feature set but active maintenance
• jjhesk/RecyclerViewMagic — Related library from same maven repo (jjhesk namespace); handles RecyclerView animations and swipe patterns
• square/okhttp — Not shown in dependencies but commonly paired for network calls in load-more pagination scenarios
• Google/android-architecture-components — Modern alternative using ViewModel + LiveData instead of manual adapter state management; UltimateRecyclerView is pre-MVVM era
• wasabeef/recyclerview-animators — Direct dependency (jp.wasabeef:recyclerview-animators:4.0.2)—handles all item insertion/removal animations in this library

To work on one of these in Claude Code or Cursor, paste: Implement the "<title>" PR idea from CLAUDE.md, working through the checklist as the task list.

Add AndroidX migration verification and update deprecated play-services-ads version

The project has namespace declarations and uses androidx.multidex, indicating partial AndroidX adoption. However, build.gradle still uses play-services-ads:22.6.0 (released 2022) which may contain deprecated APIs. Additionally, the maven repository uses deprecated Bintray (http://dl.bintray.com/jjhesk/maven). This PR should update to latest Google Play Services, verify all dependencies are AndroidX-compatible, and migrate to JCenter or Maven Central alternatives.

• [ ] Update com.google.android.gms:play-services-ads to latest stable version (24.x+)
• [ ] Replace deprecated Bintray maven repo with jcenter() or mavenCentral()
• [ ] Run lint checks to identify any remaining non-AndroidX dependencies
• [ ] Update README with AndroidX compatibility statement
• [ ] Test with both debug and release builds across the demo app

Add unit tests for RecyclerViewAdapter core functionality in ultimaterecyclerview library

The repo has extensive demo apps (admobdemo/, dragdemo/, expandemo/, griddemo/, multiitemdemo/) but the test directory only contains ApplicationTest.java. The ultimaterecyclerview library module (referenced as api project(':ultimaterecyclerview')) lacks unit tests for adapter functionality, load-more behavior, refresh mechanisms, and animation features that are core to this library.

• [ ] Create test/java/com/marshalchen/ultimaterecyclerview/ directory structure in ultimaterecyclerview library
• [ ] Add unit tests for adapter base classes (test ViewHolder binding, item updates, animations)
• [ ] Add tests for load-more callback logic and state management
• [ ] Add tests for refresh/pull-to-refresh state transitions
• [ ] Add tests for multi-view-type adapter scenarios (referencing multiitemdemo logic)
• [ ] Ensure tests run on CI pipeline (.travis.yml)

Add GitHub Actions CI workflow and deprecate Travis CI

The project uses .travis.yml for CI (as shown in README badges), but Travis CI has deprecated free tier for public repos as of end of 2020. GitHub Actions is now the standard for GitHub projects. This PR should create a modern GitHub Actions workflow while maintaining build compatibility with Java 17 (as specified in compileOptions).

• [ ] Create .github/workflows/android-build.yml with matrix build for minSdkVersion 21 and latest API
• [ ] Configure workflow to run on push to master and dev branches, and on pull requests
• [ ] Add gradle build with appropriate caching for faster CI runs
• [ ] Include lint checks and test execution steps
• [ ] Update README.md to replace Travis CI badges with GitHub Actions badges
• [ ] Document the migration in CONTRIBUTING.md (create if missing)

• Write unit tests for SimpleAdapter and GridStringAdapter—currently no test files visible under src/androidTest/java beyond ApplicationTest.java skeleton. Add RecyclerView lifecycle and adapter callback tests.
• Update jp.wasabeef:recyclerview-animators from 4.0.2 to latest (requires Kotlin, may need ItemAnimator refactoring)—document breaking changes and add migration examples to loadmoredemo/.
• Create comprehensive JavaDoc for UltimateRecyclerView public API (adapter base classes, refresh/load-more callbacks, header/footer setup)—no docs visible in file list despite complex feature set.

The codebase has moderate security concerns, primarily related to insecure repository URLs, outdated dependencies, and disabled code obfuscation in release builds. The most critical issues are: (1) HTTP repository URL allowing MITM attacks, (2) ProGuard minification disabled enabling reverse engineering, and (3) outdated Google Play Services dependency. Immediate remediation should focus on enforcing HTTPS for repositories and enabling code obfuscation for production builds. Dependency

• High · Insecure HTTP Repository URL — UltimateRecyclerView/app/build.gradle - repositories section. The build configuration uses an insecure HTTP URL for the Maven repository (http://dl.bintray.com/jjhesk/maven). This allows potential man-in-the-middle (MITM) attacks where dependencies could be intercepted and replaced with malicious versions. Fix: Replace 'http://' with 'https://' to ensure encrypted communication: maven { url 'https://dl.bintray.com/jjhesk/maven' }
• Medium · Outdated Google Play Services Dependency — UltimateRecyclerView/app/build.gradle - dependencies section. The Google Play Services Ads library version 22.6.0 is outdated and may contain known security vulnerabilities. Current versions are significantly higher (version 20.0.0+ released in 2021, with much newer versions available). Fix: Update to the latest stable version of play-services-ads. Run 'gradle dependencyUpdates' to identify available updates and update to at least version 20.0.0 or higher.
• Medium · Debug Build with Leak Detection in Production — UltimateRecyclerView/app/build.gradle - dependencies section. LeakCanary is configured as a debugImplementation dependency, which is correct. However, if accidentally switched to 'implementation', it would run in production builds and could expose sensitive memory information or impact performance. Fix: Ensure LeakCanary remains as 'debugImplementation' only. Add a comment to prevent accidental modification. Consider using a build variant check to explicitly prevent inclusion in release builds.
• Medium · ProGuard Minification Disabled in Release Builds — UltimateRecyclerView/app/build.gradle - buildTypes.release section. The release build configuration has 'minifyEnabled false', meaning release APKs are not obfuscated or minified. This makes the code easily reversible through decompilation, allowing attackers to analyze and extract sensitive logic, hardcoded values, or API keys. Fix: Enable minification for release builds: 'minifyEnabled true'. Provide appropriate ProGuard rules in proguard-rules.pro to keep necessary classes while obfuscating sensitive code.
• Low · Lint Errors Not Enforced — UltimateRecyclerView/app/build.gradle - lintOptions section. The lintOptions configuration has 'abortOnError false', which suppresses lint errors during the build process. This can allow security-related lint warnings to go unnoticed. Fix: Change to 'abortOnError true' or at least 'abortOnError false' with explicit lint checks enabled for security-critical rules. Review and address all lint warnings regularly.
• Low · Potential Deprecated Bintray Repository — UltimateRecyclerView/app/build.gradle - repositories section. Bintray (dl.bintray.com) was sunset by JFrog in 2021. While the repository may still work, it's no longer officially supported and could become unavailable, impacting builds. Fix: Migrate dependencies to Maven Central or another actively maintained repository. Verify that 'loyalslider' library is available in modern repositories or consider alternatives.
• Low · MultiDex Enabled Without Justification — UltimateRecyclerView/app/build.gradle - defaultConfig section. MultiDex is enabled in the defaultConfig. While necessary for apps exceeding 65k methods, it should be used only when required and can complicate debugging and increase build complexity. Fix: Verify if multiDexEnabled is necessary by checking the actual method count. If not needed, remove this line to simplify the build configuration.

LLM-derived; treat as a starting point, not a security audit.

• Open issues — current backlog
• Recent PRs — what's actively shipping
• Source on GitHub

Generated by RepoPilot. Verdict based on maintenance signals — see the live page for receipts. Re-run on a new commit to refresh.