panza

Panza (named after Sancho Panza, from Don Quixote), is a collection of stateless, functional ui-components for react-native, and heavily inspired by the excellent rebass library. 

The goal with Panza is to provide a set of commonly used (mostly) functional ui components for react-native, that work well in both android and iOS environments. These components should look nice out of the box, but still offer a high degree of customization. This is achieved primarily through the use of composition. Each component is comprised of smaller components including a Base component, which provides some nice shorthands to transform props into styles based upon a global configuration. A component like TouchableRow may suit your needs eighty percent of the time, but in cases where you need something a bit more custom, you can construct your own row using TouchableRowCell, PrimaryText, SecondaryText, RowImage, Base, ArrowRightIcon, and any other components that you’d like.

You can see Panza in production with Payback, an app that manages shared expenses between individuals and groups.

Getting Started

$ npm i panza --save
$ npm i react-native-vector-icons --save
$ rnpm link react-native-vector-icons

Components

Inputs

• InputRow
• InputGroup
• InputHelpText
• InputToggle
• InputPicker
• InputDatePicker
• RemovableInput
• AddRow
• TouchableInput

Rows

• TouchableRow
• RowSeparator
• RowImage
• SectionHeader

Navigation

• NavBar
• NavTitle
• NavTouchableIcon
• NavTouchableText
• SubNav

Pages

• ErrorPage
• LoadingPage

Buttons

• Button
• PrimaryButton
• WarningButton
• ErrorButton
• SuccessButton
• NakedButton
• VerticalButtonGroup

Text

• PrimaryText
• SecondaryText
• LargeText
• SubtitleText
• PrimaryTextInput
• SecondaryTextInput

Images

• FadeImage

Icons

• Icon
• TouchableIcon
• PlusIcon
• ArrowRightIcon
• CloseIcon
• BackIcon
• SearchIcon
• MoreIcon

Base Components

• Base
• TextBase

Customize

You can override parts of the global configuration to provide custom colours, font sizes, scales, etc.

import { config } from 'panza'

class App extends React.Component {

  static childContextTypes = {
    panza: PropTypes.object
  }

  getChildContext() {
    panza: this.state.styles
  }

  state = {
    styles: {
      colors: Object.assign(
        {},
        config.colors,
        { primary: config.colors.red } // change the primary color from blue to red
      )
    }
  }

  // ... render your app
}

Example

You can install the example application contained within this repository.

$ git clone https://github.com/bmcmahen/panza.git
$ cd panza && npm install
$ react-native run-ios
$ react-native run-android

License

MIT