📝 [Sticky] UI Kitten 5.0 Discussion & Roadmap

This is a communication-open issue indicating version 5.0 roadmap. Yes, we’re going to skip future 4.x releases since it will introduce some breaking changes 💣

Our plan is:

Features

• ~📆 Time Picker #778~ (postponed)

• 📚 Documentation for Eva Theme System.

For now, we realize that background-basic-color-1 looks like a magic string. And that’s why we should describe all theme variables exported from Eva and describe how and where they’re used and where not.

Bug Fixes

• We’re going to close several minor issues during the 4.4.x patch releases. If you have some, please open an issue or send us a PR so we can handle it.

Refactoring

• 🤔More flexibility in component props by rethinking current APIs.

We’re going to add support of passing Component classes as well as Functional components to component props. A good example for this is a title property of TopNavigation component which more likely can include an Image.

This should close the following issues: #564 #737 #777 #810 #863

Currently, we’re investigating this feature and looking for a good architecture solution. If you have any suggestions, feel free to mention them in the discussion.

• 💣 BREAKING: Unification of property names. For example, Select and Autocomplete items should have a same property name for a title. Currently, text and title are used.

• 💣 [NOT ACCEPTED] BREAKING: Unification with React Native property names. For example, use title property for button instead of passing text as children. Let us know how do you feel about that.

Migration

• Starting from v5, this repository will be moved under Eva Design project.

• Also, keep in mind that we’re going to completely deprecate react-native-ui-kitten package in order to use @ui-kitten/components.

---

⚠️

We’re not going to include more feature requests in 5.0. In this discussion, we accept proposals regarding the features described above.

Please open a new issue if you have a feature request or questions regarding the current API in order to help us keep this conversation clean.

[artyorsh]

@rdewolff v5 stable will come during the next two weeks. I plan to close several known issues before the version update (you can track it in #1055). This version will not include new components unfortunately.

[artyorsh]

New syntax example

v4 Input

You can render only a Text inside label property.

<Input 
  label='Movies'
  labelStyle={{ color: 'red' }}
/>

v5 Input

You can render anything inside label property, but labelStyle will be deprecated.

<Input label='Movies' /> // Let Eva handle stylings

// OR let me customize it

const Label = (props) => (
  <Text {...props} style={[props.style, { color: 'red' }]}>Movies</Text>
);

<Input label={Label} />