연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.
StepperListView
A customizable Flutter widget for building beautiful stepper-based list UIs such as timelines, activity histories, event logs, and more.

Installation
Add to your pubspec.yaml:
dependencies:
stepper_list_view: <latest_version>
Features
✔ Stepper-style list items
✔ Highly customizable UI
✔ Custom avatar builder
✔ Custom step label builder
✔ Custom content builder
✔ Optional stepper line on last item
✔ Supports list sorting
✔ Smooth physics support
✔ Custom dashed or solid line
✔ Easy integration
Documentation
Component
Description
StepperListView
Main widget that renders the entire stepper UI
StepperItemData
Data model for each list item
StepperThemeData
Customization for stepper line and visuals
RootPainter
Internal painter that draws the connecting line
Customize options
StepperThemeData
Property
Description
lineColor
Color of the line connecting steps
lineWidth
Thickness of the line
dashLength
Dash segment length (for dashed lines)
dashGap
Gap between dashes
Builder Options
Callback
Purpose
stepAvatar
Builds avatar or step icon
stepWidget
Builds the label beside the avatar
stepContentWidget
Builds the main content area
Usage/Examples
import 'package:flutter/foundation.dart' ;
import 'package:flutter/material.dart' ;
import 'package:stepper_list_view/stepper_list_view.dart' ;
import 'package:url_launcher/url_launcher.dart' ;
void main () {
runApp (const MyApp ());
}
class MyApp extends StatelessWidget {
const MyApp ({super .key});
@override
Widget build (BuildContext context) {
return MaterialApp (
title: 'Flutter Demo' ,
theme: ThemeData (
primarySwatch: Colors .orange,
),
home: const MyHomePage (title: 'Stepper List Demo' ),
);
}
}
class MyHomePage extends StatefulWidget {
const MyHomePage ({super .key, required this .title});
final String title;
@override
State <MyHomePage > createState () => _MyHomePageState ();
}
class _MyHomePageState extends State <MyHomePage > {
final _stepperData = List .generate (10 , (index) => StepperItemData (
id: '$index ' ,
content: ({
'name' : 'Subhash Chandra Shukla' ,
'occupation' : 'Flutter Development' ,
'mobileNumber' : '7318459902' ,
'email' : 'subhashchandras7318@gmail.com' ,
'born_date' : '12\nAug' ,
"contact_list" : {
"LinkedIn" : "https://www.linkedin.com/in/subhashcs/" ,
"Portfolio" : "https://subhashdev121.github.io/subhash/#/" ,
}
}),
avatar: 'https://avatars.githubusercontent.com/u/70679949?v=4' ,
)).toList ();
@override
Widget build (BuildContext context) {
final theme = Theme .of (context);
return Scaffold (
appBar: AppBar (
title: Text (
widget.title,
style: const TextStyle (
color: Colors .white,
),
),
),
body: Padding (
padding: const EdgeInsets .all (20.0 ),
child: StepperListView (
showStepperInLast: true ,
stepperData: _stepperData,
stepAvatar: (_, data) {
final stepData = data as StepperItemData ;
return PreferredSize (
preferredSize: const Size .fromRadius (20 ),
child: CircleAvatar (
backgroundImage: NetworkImage (
stepData.avatar!,
),
),
);
},
stepWidget: (_, data) {
final stepData = data as StepperItemData ;
return PreferredSize (
preferredSize: const Size .fromWidth (30 ),
child: Text (
stepData.content['born_date' ] ?? '' ,
style: TextStyle (
color: theme.primaryColor,
fontSize: 13 ,
),
textAlign: TextAlign .center,
),
);
},
stepContentWidget: (_, data) {
final stepData = data as StepperItemData ;
return Container (
margin: const EdgeInsets .only (
top: 20 ,
),
padding: const EdgeInsets .all (
15 ,
),
child: ListTile (
contentPadding: const EdgeInsets .all (7 ),
visualDensity: const VisualDensity (
vertical: -4 ,
horizontal: -4 ,
),
title: Text (stepData.content['name' ] ?? '' ),
subtitle: Column (
mainAxisSize: MainAxisSize .min,
crossAxisAlignment: CrossAxisAlignment .start,
children: [
const SizedBox (
height: 10 ,
),
Row (
children: [
const Expanded (
flex: 3 ,
child: Icon (Icons .work),
),
Expanded (
flex: 7 ,
child: Text (stepData.content['occupation' ] ?? '' ),
),
],
),
const SizedBox (
height: 10 ,
),
Row (
children: [
const Expanded (
flex: 3 ,
child: Icon (Icons .phone),
),
Expanded (
flex: 7 ,
child: Text (stepData.content['mobileNumber' ] ?? '' ),
),
],
),
const SizedBox (
height: 10 ,
),
Row (
children: [
const Expanded (
flex: 3 ,
child: Icon (Icons .email),
),
Expanded (
flex: 7 ,
child: Text (stepData.content['email' ] ?? '' ),
),
],
),
const SizedBox (
height: 20 ,
),
Text (
'Contact Link' ,
style: theme.textTheme.titleMedium,
),
const SizedBox (
height: 7 ,
),
Padding (
padding: const EdgeInsets .only (left: 10 ),
child: Column (
mainAxisSize: MainAxisSize .min,
crossAxisAlignment: CrossAxisAlignment .start,
children: [
Row (
crossAxisAlignment: CrossAxisAlignment .start,
children: [
Expanded (
flex: 3 ,
child: Text (
'Linked-In' ,
style: theme.textTheme.caption,
),
),
Expanded (
flex: 7 ,
child: GestureDetector (
onTap: () {
_launchURL (stepData.content['contact_list' ]['LinkedIn' ]);
},
child: Text (
stepData.content['contact_list' ]['LinkedIn' ] ?? '' ,
style: theme.textTheme.titleMedium?.copyWith (
color: Colors .blue,
decoration: TextDecoration .underline,
),
),
),
),
],
),
const SizedBox (
height: 10 ,
),
Row (
crossAxisAlignment: CrossAxisAlignment .start,
children: [
Expanded (
flex: 3 ,
child: Text (
'Portfolio' ,
style: theme.textTheme.caption,
),
),
Expanded (
flex: 7 ,
child: GestureDetector (
onTap: () {
_launchURL (stepData.content['contact_list' ]['Portfolio' ]);
},
child: Text (
stepData.content['contact_list' ]['Portfolio' ] ?? '' ,
style: theme.textTheme.titleMedium?.copyWith (
color: Colors .blue,
decoration: TextDecoration .underline,
),
),
),
),
],
),
],
),
),
const SizedBox (
height: 20 ,
),
],
),
shape: RoundedRectangleBorder (
borderRadius: BorderRadius .circular (8 ),
side: BorderSide (
color: theme.dividerColor,
width: 0.8 ,
),
),
),
);
},
stepperThemeData: StepperThemeData (
lineColor: theme.primaryColor,
lineWidth: 5 ,
),
physics: const BouncingScrollPhysics (),
),
),
);
}
Future <void > _launchURL (String ? url) async {
if (url == null ) {
return ;
}
try {
if (await canLaunchUrl (Uri .parse (url))) {
await launchUrl (Uri .parse (url));
}
return ;
} catch (e) {
if (kDebugMode) {
print ('Failed to launch URL - $e ' );
}
}
}
}
Motivation
During development of one of my apps, I needed a highly customizable stepper-style list layout that could:
Display a date or time label
Show a circle avatar or custom step widget
Display rich content beside each step
Since Flutter doesn’t provide such a widget out of the box, StepperListView was created.
Demo
🚀 About Me
I’m a Flutter Developer passionate about reusable UI components and designing elegant UI systems.
🔗 Links
License
This project is licensed under the MIT License.
See the LICENSE file for full details.