React Native Schedule View

This React Native component provides a scheduling view with space for unused time. Similar to Google Calendar's Day View.

Installing

Installing is pretty simple:

npm install rnschedule

yarn add rnschedule

Example

import React from 'react';
import RNSchedule from 'rnschedule';

const data = [
    {
      title: 'Lunch Appointment',
      subtitle: 'With Harry',
      start: new Date(2018, 11, 2, 13, 20),
      end: new Date(2018, 11, 2, 14, 20),
      color: '#390099',
    }
  ]

const App = () =>
  <RNSchedule
    dataArray={data}
    onEventPress={(appt) => console.log(appt)}
  />

export default App

Demo

Features

Moving "now" bar.
Initial loads view on today centered on "now."
Customizable appointment colors.
Scaled size of an hour to improve readability on various device sizes.
Adjustable hour sizing to make it size to whatever you want.

Properties API

None of the following properties are required. A simple Will still render an empty schedule.

Prop	Description	Default	Type
`hourSize`	Change the width of lines between hours.	`depends on screen size`	Number
`headerColor`	Background color of the calendar header strip. Acceptable formats: Hex, RGB(A), HSL(A), HSV(A), and named strings. See Tinycolor for all formats.	`#F5F5F6`	String or Object
`dataArray`	Array of date appointment objects. See below example.	`Empty Array`	Array
`leftIcon`	Include your own icon to the left of the day number.	`Null`	React Component
`accentColor`	Color of day circle in top left. Accepts Tinycolor formats.	`#1976d2`	String or Object
`status_bar`	Do you want extra margin for the status bar for iOS?	`true`	Boolean
`onEventPress`	Return function for pressing a schedule event. Returns original data.	`null`	Function

Data Array Appt Objects

The dataArray prop must be an Array of appointment objects with the following format.

[
  {
    title: 'Lunch Appointment',
    subtitle: 'With Harry',
    start: new Date(2018, 11, 2, 13, 20),
    end: new Date(2018, 11, 2, 14, 20),
    color: '#390099'
  }
]

Appt Object API

Key	Description	Type	Req
`title`	Top title for the appointment.	String	`Required`
`subtitle`	Slightly less bolded subtitle.	String	`Not Required`
`start`	When the appointment starts.	Date	`Required`
`end`	When the appointment ends.	Date	`Required`
`color`	Background color for the appointment.	Tinycolor Accepted String/Object	`Not Required`

For onEventPress function - additional properties may be passed so long as they don't interfere with the above api.

Built With

React Native Calendars (Wix) - Day selection
Tinycolor - Smart Color Management
Moment - Date/Time manipulation
React Native Collapsible - Calendar drop down

Thanks to these wonderful people for making some great stuff.

Contributing

I'm looking to add new contributors/maintainers to help out. So if you like this repo and want to help make it better let me know.

To-Do List

The component is very much under-construction. Want to help build something? Here is my to-do list:

Provide more control over Day Selector Styling.
Work on speed optimization.
Swipe to change days.
Full Day appointments.
Multi-Day appointments.
Option for dots on days with appts.
Events longer than 24 hours.
Spec UI to Material Design.
Build out testing.
Contribution guidelines.
Break out schedule view as stand-alone without cal select header.
Fix Shadowing on Header - feels weird.

Special Thanks

Special thanks to Wix's RN Calendar for getting things started and providing inspiration.

sprmn/rnschedule