Skip to content

feat: add FlashList example list screen - #32

Merged
MounirDhahri merged 1 commit into
mainfrom
claude/flashlist
Jul 10, 2026
Merged

feat: add FlashList example list screen#32
MounirDhahri merged 1 commit into
mainfrom
claude/flashlist

Conversation

@MounirDhahri

Copy link
Copy Markdown
Member

Description

Demonstrates the preferred list component, @shopify/flash-list (use it instead of FlatList for long/performant lists — Eigen/Energy convention).

  • Add @shopify/flash-list@2.2.2.
  • ExampleListScreen renders a simple FlashList of sample items with a separator.
  • Added as a "List" tab in HomeTabs (v7 static config).

PR Checklist

  • Small example/scaffold; existing tests unaffected
  • Not run locally (repo automation caveats); CI covers tsc/test/lint

🤖 Generated with Claude Code


Generated by Claude Code

- Add @shopify/flash-list (preferred over FlatList for performant lists)
- ExampleListScreen renders a simple FlashList of sample items
- Add it as a "List" tab in HomeTabs

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KPWjhmaeq8DnsiiFD9Eg7A
@artsyit

artsyit commented Jul 10, 2026

Copy link
Copy Markdown
Collaborator
Warnings
⚠️

Changes were made to package.json, but not to yarn.lock.
Perhaps you need to run yarn install?

New dependencies added: @shopify/flash-list.

@shopify/flash-list

Used in package.json
Author: shopify Description: FlashList is a more performant FlatList replacement
License: MIT Homepage: https://shopify.github.io/flash-list/
Keywords: react-native, recyclerview, listview, flatlist-alternative, flatlist, recyclerlistview, 60fps, cross-platform, react-native-web and performance
Updated: about 1 month ago Created: about 4 years ago
Releases: 79 Maintainers: 6
README

FlashList Image

WebsiteDiscordGetting startedUsagePerformanceKnown Issues

Fast & performant React Native list. No more blank cells.

Swap from FlatList in seconds. Get instant performance.

FlashList v2

FlashList v2 has been rebuilt from the ground up for RN's new architecture and delivers fast performance, higher precision, and better ease of use compared to v1. We've achieved all this while moving to a JS-only solution! One of the key advantages of FlashList v2 is that it doesn't require any estimates. It also introduces several new features compared to v1. To know more about what's new in v2 click here.

⚠️ IMPORTANT: FlashList v2.x has been designed to be new architecture only and will not run on old architecture. If you're running on old architecture or using FlashList v1.x, you can access the documentation specific to v1 here: FlashList v1 Documentation.

Why use FlashList?

🚀 Superior Performance

  • No more blank cells: FlashList uses view recycling to ensure smooth scrolling without visible blank areas.
  • Fast initial render: Optimized for quick first paint.
  • Efficient memory usage: Recycles views instead of destroying them, reducing memory overhead.
  • Supports view types: Great performance even if different types of components make up the list.
  • Dynamic sizes: Super fast and doesn't need any estimates.

🎯 Developer Experience

  • Drop-in replacement for FlatList: Simply change the component name - if you know FlatList, you already know FlashList.
  • No size estimates required in v2: Unlike v1, FlashList v2 automatically handles item sizing.
  • Type-safe: Full TypeScript support with comprehensive type definitions.

📱 Advanced Features

  • Masonry layout support: Create Pinterest-style layouts with varying item heights and column spans.
  • Maintain visible content position: Automatically handles content shifts when adding items (enabled by default in v2).
  • Multiple recycling pools: Optimizes performance for lists with different item types using getItemType.
  • Built for React Native's new architecture: FlashList v2 is designed specifically for the new architecture.

⚡ Real-world Benefits

  • Reduced frame drops: Maintains 60 FPS even with complex item components.
  • Lower CPU usage: Efficient recycling reduces computational overhead.
  • Smoother scrolling: Predictable performance even with thousands of items.
  • JS-only solution in v2: No native dependencies, making it easier to maintain while delivering fast performance.

Installation

Add the package to your project via yarn add @shopify/flash-list.

Usage

But if you are familiar with FlatList, you already know how to use FlashList. You can try out FlashList by changing the component name or refer to the example below:

import React from "react";
import { View, Text } from "react-native";
import { FlashList } from "@shopify/flash-list";

const DATA = [
  {
    title: "First Item",
  },
  {
    title: "Second Item",
  },
];

const MyList = () => {
  return (
    <FlashList
      data={DATA}
      renderItem={({ item }) => <Text>{item.title}</Text>}
    />
  );
};

To avoid common pitfalls, you can also follow these steps for migrating from FlatList.

App / Playground

The fixture is an example app showing how to use the library.

Generated by 🚫 dangerJS against 50ae730

@MounirDhahri
MounirDhahri merged commit e2c36ff into main Jul 10, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants