Home

Awesome

<div align="center"><img src="https://github.com/aagarwal1012/IntroViews-Flutter/blob/master/display/header.png?raw=true"/></div> <br/> <div align="center"> <a href="https://flutter.io"> <img src="https://img.shields.io/badge/Platform-Flutter-yellow.svg" alt="Platform" /> </a> <a href="https://pub.dev/packages/intro_views_flutter"> <img src="https://img.shields.io/pub/v/intro_views_flutter.svg" alt="Pub Package" /> </a> <img src="https://github.com/aagarwal1012/IntroViews-Flutter/actions/workflows/build.yml/badge.svg" alt="Build Status" /> <img src="https://github.com/aagarwal1012/IntroViews-Flutter/actions/workflows/tests.yml/badge.svg" alt="Tests Status" /> <a href="https://codecov.io/gh/aagarwal1012/IntroViews-Flutter"> <img src="https://codecov.io/gh/aagarwal1012/IntroViews-Flutter/branch/master/graph/badge.svg" alt="Codecov Coverage" /> </a> <a href="https://opensource.org/licenses/MIT"> <img src="https://img.shields.io/badge/License-MIT-red.svg" alt="License: MIT" /> </a> <a href="https://www.paypal.me/aagarwal1012"> <img src="https://img.shields.io/badge/Donate-PayPal-green.svg" alt="Donate" /> </a> </div><br>

IntroViews is inspired by Paper Onboarding and developed with love from scratch. Checkout our fully responsive live example app.

Table of contents

<img src="https://github.com/aagarwal1012/IntroViews-Flutter/blob/master/display/output.gif?raw=true" align = "right" height = "550px">

Features

Getting Started

You should ensure that you add the intro_views_flutter as a dependency in your flutter project.

dependencies:
  intro_views_flutter: '^3.2.0'

You can also reference the git repository directly if you want:

dependencies:
  intro_views_flutter:
    git: git://github.com/aagarwal1012/IntroViews-Flutter

You should then run flutter packages get in your terminal so as to get the package.

Usage

<img src = "https://github.com/aagarwal1012/IntroViews-Flutter/blob/master/display/page3.png?raw=true" align = "right" height = "450px"/>

Documentation

PageViewModel Class

Dart attributeDatatypeDescriptionDefault Value
pageColorColor?Set color of the page.Null
pageBackgroundWidgetSet a widget as a background of the whole page (pageColor has priority)Null
mainImageImage / WidgetSet the main image of the page. If null, then the widget is omitted.-
titleText / WidgetSet the title text of the page. If null, then the widget is omitted.-
bodyText / WidgetSet the body text of the page. If null, then the widget is omitted.-
iconImageAssetPathString?Set the icon image asset path that would be displayed in page bubble.Null
iconColorColor?Set the page bubble icon color.Null
bubbleBackgroundColorColorSet the page bubble background color.Colors.white / Color(0x88FFFFFF)
textStyleTextStyle?Set TextStyle for both title and bodytitle: color: Colors.white , fontSize: 50.0 <br> body: color: Colors.white , fontSize: 24.0
titleTextStyleTextStyleSet TextStyle for titlecolor: Colors.white , fontSize: 50.0
bodyTextStyleTextStyleSet TextStyle for bodycolor: Colors.white , fontSize: 24.0
bubbleWidget?Set a custom widget for the inner bubbleNull

IntroViewFlutter Class

Dart attributeDatatypeDescriptionDefault Value
pagesList<PageViewModel>Set the pages of the intro screen.(required)
onTapDoneButtonVoidCallback?Method executes on tapping done button.Null
onTapBackButtonVoidCallback?Method executes on tapping back button.Null
onTapNextButtonVoidCallback?Method executes on tapping next button.Null
showSkipButtonboolShow the skip button at the bottom of page.true
showBackButtonboolShow the Back button at the bottom of page. Overrides showSkipButton starting from the second pagefalse
showNextButtonboolShow the Next button at the bottom of page. Overrides doneButtonPersist.false
pageButtonTextSizedoubleSet the button text size.18.0
pageButtonFontFamilyString?Set the font of button text.Null
onTapSkipButtonVoidCallback?Method executes on tapping skip button.Null
pageButtonTextStylesTextStyle?Configure TextStyle for skip, done buttons, overrides pageButtonFontFamily, pageButtonsColor, pageButtonTextSize.fontSize: 18.0, color: Colors.white
skipTextText / WidgetOverride Skip Button Text and styles.Text('SKIP')
doneTextText / WidgetOverride Done Button Text and styles.Text('DONE')
backTextText / WidgetOverride Back Button Text and styles.Text('BACK')
nextTextText / WidgetOverride Next Button Text and styles.Text('NEXT')
doneButtonPersistboolShow done Button throughout pagesfalse
columnMainAxisAlignmentMainAxisAlignmentControl [MainAxisAlignment] for columnMainAxisAlignment.spaceAround
fullTransitiondoubleAdjust scroll distance for full transition300.0
backgroundColor?Set the background color to Colors.transparent if you have your own background image belowNull

For help on editing package code, view the flutter documentation.

Bugs or Requests

If you encounter any problems feel free to open an issue. If you feel the library is missing a feature, please raise a ticket on GitHub and I'll look into it. Pull request are also welcome.

See Contributing.md.

Donate

If you found this project helpful or you learned something from the source code and want to thank me, consider buying me a cup of :coffee:

Contributors

Thanks goes to these wonderful people (emoji key):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> <!-- prettier-ignore-start --> <!-- markdownlint-disable --> <table> <tr> <td align="center"><a href="https://github.com/taljacobson"><img src="https://avatars1.githubusercontent.com/u/13042769?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Tal Jacobson</b></sub></a><br /><a href="#maintenance-taljacobson" title="Maintenance">๐Ÿšง</a> <a href="https://github.com/aagarwal1012/IntroViews-Flutter/commits?author=taljacobson" title="Documentation">๐Ÿ“–</a> <a href="#projectManagement-taljacobson" title="Project Management">๐Ÿ“†</a></td> <td align="center"><a href="https://github.com/marloncepeda"><img src="https://avatars0.githubusercontent.com/u/25042632?v=4?s=100" width="100px;" alt=""/><br /><sub><b>marloncepeda</b></sub></a><br /><a href="https://github.com/aagarwal1012/IntroViews-Flutter/issues?q=author%3Amarloncepeda" title="Bug reports">๐Ÿ›</a></td> <td align="center"><a href="https://medium.com/it-challenge"><img src="https://avatars0.githubusercontent.com/u/963316?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Kravchenko Igor</b></sub></a><br /><a href="https://github.com/aagarwal1012/IntroViews-Flutter/issues?q=author%3AGorniv" title="Bug reports">๐Ÿ›</a></td> <td align="center"><a href="https://github.com/SiDevesh"><img src="https://avatars2.githubusercontent.com/u/17254413?v=4?s=100" width="100px;" alt=""/><br /><sub><b>SiDevesh</b></sub></a><br /><a href="#ideas-SiDevesh" title="Ideas, Planning, & Feedback">๐Ÿค”</a></td> <td align="center"><a href="https://have-you-been-here.com/"><img src="https://avatars2.githubusercontent.com/u/1579235?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Slawa Pidgorny</b></sub></a><br /><a href="#ideas-spidgorny" title="Ideas, Planning, & Feedback">๐Ÿค”</a></td> <td align="center"><a href="https://haideraltahan.com"><img src="https://avatars1.githubusercontent.com/u/4427929?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Haider Al-Tahan</b></sub></a><br /><a href="#ideas-haideraltahan" title="Ideas, Planning, & Feedback">๐Ÿค”</a></td> <td align="center"><a href="https://newerton.com"><img src="https://avatars3.githubusercontent.com/u/4175945?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Newerton</b></sub></a><br /><a href="https://github.com/aagarwal1012/IntroViews-Flutter/issues?q=author%3Anewerton" title="Bug reports">๐Ÿ›</a></td> </tr> <tr> <td align="center"><a href="https://www.discoos.org"><img src="https://avatars3.githubusercontent.com/u/866528?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Kenneth Gulbrandsรธy</b></sub></a><br /><a href="https://github.com/aagarwal1012/IntroViews-Flutter/issues?q=author%3Akengu" title="Bug reports">๐Ÿ›</a> <a href="https://github.com/aagarwal1012/IntroViews-Flutter/commits?author=kengu" title="Tests">โš ๏ธ</a></td> <td align="center"><a href="https://www.linkedin.com/in/xsahil03x"><img src="https://avatars2.githubusercontent.com/u/25670178?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Sahil Kumar</b></sub></a><br /><a href="https://github.com/aagarwal1012/IntroViews-Flutter/commits?author=xsahil03x" title="Tests">โš ๏ธ</a></td> <td align="center"><a href="https://www.yodsoft.com"><img src="https://avatars1.githubusercontent.com/u/2169309?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Rodrigo Boratto</b></sub></a><br /><a href="https://github.com/aagarwal1012/IntroViews-Flutter/issues?q=author%3Arwrz" title="Bug reports">๐Ÿ›</a></td> <td align="center"><a href="https://github.com/RKKgithub"><img src="https://avatars2.githubusercontent.com/u/63288678?v=4?s=100" width="100px;" alt=""/><br /><sub><b>RKKgithub</b></sub></a><br /><a href="https://github.com/aagarwal1012/IntroViews-Flutter/commits?author=RKKgithub" title="Code">๐Ÿ’ป</a></td> <td align="center"><a href="https://ir2pid.github.io"><img src="https://avatars.githubusercontent.com/u/907075?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Sudipta Dutta</b></sub></a><br /><a href="https://github.com/aagarwal1012/IntroViews-Flutter/issues?q=author%3Air2pid" title="Bug reports">๐Ÿ›</a></td> <td align="center"><a href="https://github.com/mzdm"><img src="https://avatars.githubusercontent.com/u/67197047?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Matฤ›j ลฝรญdek</b></sub></a><br /><a href="https://github.com/aagarwal1012/IntroViews-Flutter/issues?q=author%3Amzdm" title="Bug reports">๐Ÿ›</a> <a href="https://github.com/aagarwal1012/IntroViews-Flutter/commits?author=mzdm" title="Code">๐Ÿ’ป</a> <a href="#platform-mzdm" title="Packaging/porting to new platform">๐Ÿ“ฆ</a> <a href="#maintenance-mzdm" title="Maintenance">๐Ÿšง</a> <a href="#ideas-mzdm" title="Ideas, Planning, & Feedback">๐Ÿค”</a> <a href="https://github.com/aagarwal1012/IntroViews-Flutter/commits?author=mzdm" title="Documentation">๐Ÿ“–</a></td> <td align="center"><a href="https://github.com/ride4sun"><img src="https://avatars.githubusercontent.com/u/7740651?v=4?s=100" width="100px;" alt=""/><br /><sub><b>ride4sun</b></sub></a><br /><a href="https://github.com/aagarwal1012/IntroViews-Flutter/commits?author=ride4sun" title="Code">๐Ÿ’ป</a></td> </tr> <tr> <td align="center"><a href="https://github.com/zognotadog"><img src="https://avatars.githubusercontent.com/u/12435592?v=4?s=100" width="100px;" alt=""/><br /><sub><b>zognotadog</b></sub></a><br /><a href="https://github.com/aagarwal1012/IntroViews-Flutter/commits?author=zognotadog" title="Code">๐Ÿ’ป</a></td> <td align="center"><a href="https://github.com/Jayson1999"><img src="https://avatars.githubusercontent.com/u/44394801?v=4?s=100" width="100px;" alt=""/><br /><sub><b>Jayson</b></sub></a><br /><a href="https://github.com/aagarwal1012/IntroViews-Flutter/issues?q=author%3AJayson1999" title="Bug reports">๐Ÿ›</a></td> </tr> </table> <!-- markdownlint-restore --> <!-- prettier-ignore-end --> <!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the all-contributors specification. Contributions of any kind welcome! See Contributing.md.

License

IntroViews-Flutter is licensed under MIT license.