react-native-beautiful-timeline
TypeScript icon, indicating that this package has built-in type declarations

1.0.1 • Public • Published

React Native Beautiful Timeline

Battle Tested ✅

Fully customizable, beautifully designed Timeline for React Native.

npm version npm Platform - Android and iOS License: MIT styled with prettier

React Native Beautiful Timeline React Native Beautiful Timeline

Installation

Add the dependency:

npm i react-native-beautiful-timeline

Peer Dependencies

IMPORTANT! You need install them
"moment": ">= 2.24.0",
"react-native-dash-2": ">= 0.2.3",
"react-native-androw" : ">= 0.0.34",
"@freakycoder/react-native-helpers": ">= 0.1.0",

Usage

Import

import Timeline from "react-native-beautiful-timeline";

Basic Usage

Data Format

The data format MUST like this example.

[
  {
    "date": 1574342522000,
    "data": [
      {
        "title": "React Native Beautiful Timeline",
        "subtitle": "Sed at justo eros. Phasellus.",
        "date": 1574342522000
      },
      {
        "title": "React Native",
        "subtitle": "Sed viverra. Nam sagittis.",
        "date": 1574342501000
      }
    ]
  },
  {
    "date": 1574248261000,
    "data": [
      {
        "title": "Timeline",
        "subtitle": "Morbi magna orci, consequat in.",
        "date": 1574248261000
      }
    ]
  },
  {
    "date": 1574125621000,
    "data": [
      {
        "title": "Beauty Timeline",
        "subtitle": "Nulla a eleifend urna. Morbi. Praesent.",
        "date": 1574125621000
      }
    ]
  }
]

Let's take a look a bit closer:

For each day & there would be limitless objects(Cards) for each day something like this example: Each card comes from data array and each day comes from each object from main array.

{
  "date": 1574342522000,
  "data": [
    {
      "title": "React Native Beautiful Timeline",
      "subtitle": "Sed at justo eros. Phasellus.",
      "date": 1574342522000
    },
    {
      "title": "React Native",
      "subtitle": "Sed viverra. Nam sagittis.",
      "date": 1574342501000
    }
  ]
}

Basic Usage

Please take a look at above data formatting. Library itself solves everything for you if the data format is correct.

<Timeline data={data} />

Configuration - Props

Coming Soon !

Future Plans

  • [x] LICENSE
  • [x] README: Better Example Image
  • [x] README: GIF Asset
  • [x] README: Data Formatting
  • [x] Configuration: Props
  • [x] Version 1
  • [ ] Without Card Feature Data Formatting Implementation (Coming soon!)
  • [ ] Write an article about the lib on Medium

Credits

Thank you for this awesome inspiration. Designed by Kamil Janus

Author

FreakyCoder, kurayogun@gmail.com

License

React Native Beautiful Timeline is available under the MIT license. See the LICENSE file for more info.

Package Sidebar

Install

npm i react-native-beautiful-timeline

Weekly Downloads

26

Version

1.0.1

License

MIT

Unpacked Size

67.8 kB

Total Files

58

Last publish

Collaborators

  • freakycoder