V2

.github/ISSUE_TEMPLATE

@@ -4,6 +4,10 @@
 
 ### Steps to Reproduce / Code Snippets / Screenshots
 
+<!-- Note: When embeding code, please format it and use syntax highlighting to improve readability -->
+<!-- ```js                                                         -->
+<!-- [ THIS CODE BLOCK WILL USE JAVASCRIPT SYNTAX HIGHLIGHTING ]   -->
+<!-- ```                                                           -->
 [FILL THIS OUT]
 
 ---

.github/stale.yml

@@ -0,0 +1,54 @@
+# Configuration for probot-stale - https://github.com/probot/stale
+
+# Number of days of inactivity before an Issue or Pull Request becomes stale
+daysUntilStale: 30
+
+# Number of days of inactivity before a stale Issue or Pull Request is closed.
+# Set to false to disable. If disabled, issues still need to be closed manually, but will remain marked as stale.
+daysUntilClose: 7
+
+# Issues or Pull Requests with these labels will never be considered stale. Set to `[]` to disable
+exemptLabels:
+  - "type: accepted/enhancement"
+  - "user: looking for contributors"
+  - "📌 pinned"
+
+# Set to true to ignore issues in a project (defaults to false)
+exemptProjects: false
+
+# Set to true to ignore issues in a milestone (defaults to false)
+exemptMilestones: false
+
+# Label to use when marking as stale
+staleLabel: "🏚 stale"
+
+# Comment to post when marking as stale. Set to `false` to disable
+markComment: >
+  This issue has been automatically marked as stale because it has not had
+  recent activity. It will be closed if no further activity occurs. 
+
+  If you believe the issue is still relevant, please test on the latest Detox and report back.
+  Thank you for your contributions.
+# Comment to post when removing the stale label.
+# unmarkComment: >
+#   Your comment here.
+
+# Comment to post when closing a stale Issue or Pull Request.
+closeComment: >
+  The issue has been closed for inactivity.
+# Limit the number of actions per hour, from 1-30. Default is 30
+limitPerRun: 30
+
+# Limit to only `issues` or `pulls`
+# only: issues
+
+# Optionally, specify configuration settings that are specific to just 'issues' or 'pulls':
+pulls:
+  daysUntilStale: 45
+  markComment: >
+    This pull request has been automatically marked as stale because it has not had
+    recent activity. It will be closed if no further activity occurs. Thank you
+    for your contributions.
+# issues:
+#   exemptLabels:
+#     - confirmed

.github/support.yml

@@ -0,0 +1,14 @@
+# Configuration for support-requests - https://github.com/dessant/support-requests
+
+# Label used to mark issues as support requests
+supportLabel: "type: question/stack overflow"
+# Comment to post on issues marked as support requests. Add a link
+# to a support page, or set to `false` to disable
+supportComment: >
+  We use the issue tracker exclusively for bug reports and feature requests.
+  This issue appears to be a general usage or support question. 
+  Instead, please ask a question on Stack Overflow with the `react-native-navigation` tag.
+# Whether to close issues marked as support requests
+close: true
+# Whether to lock issues marked as support requests
+lock: false

.gitignore

@@ -1,6 +1,7 @@
 dist
 .vscode/
 package-lock.json
+.history/
 
 ############
 # Node

.npmignore

@@ -106,6 +106,8 @@ lib/ios/xcuserdata/
 ## Other
 *.moved-aside
 *.xcuserstate
+.github/
+docs/
 
 ## Obj-C/Swift specific
 *.hmap

README.md

@@ -0,0 +1,24 @@
+![npm](https://img.shields.io/npm/dw/react-native-navigation.svg)
+[![npm (tag)](https://img.shields.io/npm/v/react-native-navigation/latest.svg)](https://github.com/wix/react-native-navigation/tree/master)
+[![npm (tag)](https://img.shields.io/npm/v/react-native-navigation/snapshot.svg)](https://github.com/wix/react-native-navigation/tree/master)
+[![Build Status](https://img.shields.io/jenkins/s/http/jenkins-oss.wixpress.com:8080/job/multi-react-native-navigation-master.svg)](https://jenkins-oss.wixpress.com/job/multi-react-native-navigation-master/)
+[![Join us on Discord](https://img.shields.io/badge/discord-react--native--navigation-738bd7.svg?style=flat)](https://discord.gg/DhkZjq2)
+[![StackExchange](https://img.shields.io/stackexchange/stackoverflow/t/react-native-navigation.svg)](https://stackoverflow.com/questions/tagged/react-native-navigation)
+
+<h1 align="center">
+  <img src=".logo.png"/><br>
+  React Native Navigation
+</h1>
+
+React Native Navigation provides 100% native platform navigation on both iOS and Android for React Native apps. The JavaScript API is simple and cross-platform - just install it in your app and give your users the native feel they deserve. Ready to get started? Check out the [docs](https://wix.github.io/react-native-navigation/).
+
+# Quick Links
+- [Documentation](https://wix.github.io/react-native-navigation/)
+- [Stack Overflow](http://stackoverflow.com/questions/tagged/react-native-navigation)
+- [Chat with us](https://discord.gg/DhkZjq2)
+- [Contributing](/docs/docs/WorkingLocally.md)
+
+# Installation
+As `react-native-navigation` is a native navigation library - integrating it into your app will require editing native files. Follow the installation guides in the [documentation](https://wix.github.io/react-native-navigation/).
+
+

ReactNativeNavigation.podspec

@@ -14,9 +14,9 @@ Pod::Spec.new do |s|
 
   s.module_name  = 'ReactNativeNavigation'
 
-  s.source       = { :git => "https://github.com/wix/react-native-navigation.git", :tag => "v#{s.version}" }
+  s.source       = { :git => "https://github.com/wix/react-native-navigation.git", :tag => "#{s.version}" }
   s.source_files  = "lib/ios/**/*.{h,m}"
-  s.exclude_files  = "lib/ios/ReactNativeNavigationTests/**/*.*"
+  s.exclude_files  = "lib/ios/ReactNativeNavigationTests/**/*.*", "lib/ios/OCMock/**/*.*"
 
   s.dependency 'React'
   s.frameworks = 'UIKit'

babel.config.js

@@ -0,0 +1,12 @@
+module.exports = function (api) {
+  api && api.cache(false);
+  return {
+    presets: [
+      "module:metro-react-native-babel-preset"
+    ],
+    plugins: [
+      "@babel/plugin-proposal-export-namespace-from",
+      "@babel/plugin-proposal-export-default-from"
+    ]
+  };
+}

docs/README.md

@@ -1,216 +1,13 @@
-![npm](https://img.shields.io/npm/dw/react-native-navigation.svg)
-[![npm (tag)](https://img.shields.io/npm/v/react-native-navigation/alpha.svg)](https://github.com/wix/react-native-navigation/tree/v2#react-native-navigation-v2-wip)
-[![Build Status](https://jenkins-oss.wixpress.com/buildStatus/icon?job=react-native-navigation-master)](https://jenkins-oss.wixpress.com/job/react-native-navigation-master/)
-[![Join us on Discord](https://img.shields.io/badge/discord-react--native--navigation-738bd7.svg?style=flat)](https://discord.gg/DhkZjq2)
-[![StackExchange](https://img.shields.io/stackexchange/stackoverflow/t/react-native-navigation.svg)](https://stackoverflow.com/questions/tagged/react-native-navigation)
+<h1 align="center">
+  <img src="https://raw.githubusercontent.com/wix/react-native-navigation/master/.logo.png"/><br>
+  React Native Navigation
+</h1>
 
+React Native Navigation provides 100% native platform navigation on both iOS and Android for React Native apps. The JavaScript API is simple and cross-platform - just install it in your app and give your users the native feel they deserve. Ready to get started? Check out the [docs](https://wix.github.io/react-native-navigation/).
 
-#  React Native Navigation v2 (WIP)
-We are rebuilding react-native-navigation.
-
-> As we are in stage alpha, expect breaking API changes or use a specific version (for example "2.0.1234")
-
-- [Why?](#why-rebuild-react-native-navigation)
-- [v2 Roadmap](#v2-roadmap)
-- [v1 vs v2 feature comparison](#v1-vs-v2-feature-comparison)
-- [Documentation](https://wix.github.io/react-native-navigation/v2/)
+# Quick Links
+- [Documentation](https://wix.github.io/react-native-navigation/)
+- [Stack Overflow](http://stackoverflow.com/questions/tagged/react-native-navigation)
+- [Chat with us](https://discord.gg/DhkZjq2)
 - [Contributing](/docs/WorkingLocally.md)
 
-## Why Rebuild react-native-navigation?
-
-### A New & Improved Core Architecture
-react-native-navigation has a few issues which are unsolvable in its current architecture. These issues stem from the same problem: you cannot specify on which screen you wish to make an action. Whenever you want to push a screen, show a modal or any other action, the action defaults to originate from your current screen. In most cases this is fine, but becomes problematic in specific edge cases. For example: <br>
-* What if you want to update your navbar icons and the user pops the screen? Your icons might update on the wrong screen.
-* What if you want to push a screen as a result of a redux action?
-
-There are ways to solve some of these problems in v1 but they are not straightforward. We want to change that.
-
-#### New API
-To solve this problem in v2, every screen receives its `componentId` as a prop. Whenever you want to perform an action from that screen you need to pass the `componentId` to the function:
-```js
-Navigator.pop(this.props.componentId)
-```
-Another big architectural change is that now you can compose arbitrary native layout hierarchies, and assign a custom `id` to each and control them individually.
-
-### Built for Contributors
-Currently, it requires a lot of work to accept pull requests. We need to manually make sure that everything works before we approve them because v1 is not thoroughly tested. <br>
-v2 is written with contributors in mind from day one.
-
-#### Written In TDD
-v2 is written in Test Driven Development. We have a test for every feature including features that are not implemented yet. This makes accepting pull requests extremely easy: If our tests pass, your pull request is accepted.
-
-## v2 Roadmap
-
-### Current Priorities
-
-1) buttons in Android
-2) showOverlay in iOS
-3) showOverlay in Android
-4) async commands
-5) currentTab
-6) change Options to be nested
-7) topTabs in both platforms, with API implications
-
-### Top API
-
-|       Top API         | iOS  | Android |
-|--------------------|:-----:|:----:|
-| setRoot   |   ✅    |   ✅  |
-| registerComponent |   ✅   |  ✅   |
-| component     |   ✅   |  ✅   |
-| sideMenu             |    ✅  |    ✅ |
-| tabs            |    ✅  |    ✅ |
-| External Component       |   ✅  |   ✅ |
-| splitView           |   [Contribute](/docs/WorkingLocally.md)   |   [Contribute](/docs/WorkingLocally.md) |
-
-### Screen API
-
-|       Screen API         | iOS  | Android |
-|--------------------|:-----:|:----:|
-| push              |   ✅       |	✅		|
-| pop               |  ✅        |	✅	|
-| popToRoot              |   ✅         |✅	|
-| popTo              |   ✅         |✅	|
-| resetTo             |   ✅        |	✅|
-| showModal              |  ✅        |	✅|
-| dismissModal           |     ✅       |	✅|
-| showOverlay             |  ✅         |	✅ |
-| dismissOverlay             |  ✅   |	✅ |
-| customTransition            |✅|✅|
-| Screen Visibility        | ✅     |✅|
-| async commands (await push)     |  ✅        |✅   |
-
-### Navigation Options
-
-|       topBar         | iOS  | Android |
-|--------------------|:----:|:-----:|
-| title         |        	✅    | 	✅|
-| textColor    | ✅     |     ✅        |
-| textFontSize       |    ✅      |     ✅|
-| textFontFamily     |      ✅     |     ✅|
-| backgroundColor    |  ✅       |     ✅|
-| buttonColor         |    ✅      |✅|
-| hidden             |   ✅      |     ✅|
-| hideOnScroll         |  ✅    |✅|
-| translucent         |   ✅     |     [Contribute](/docs/WorkingLocally.md)        |
-| transparent         |  ✅        |     [Contribute](/docs/WorkingLocally.md)        |
-| noBorder             |    ✅     |     [Contribute](/docs/WorkingLocally.md)        |
-| drawUnder         |    ✅     |✅|
-| blur               |    ✅     |      [Contribute](/docs/WorkingLocally.md)       |
-| custom component          |✅     |✅|
-| background component          |✅     |✅|
-| subtitleColor            |   ✅      |✅|
-| subtitleFontFamily      |✅|✅|
-| largeTitle (iOS 11)      |    ✅     |     /iOS Specific       |
-
-|       tabBar         | iOS  | Android |
-|--------------------|:----:|:-----:|
-| drawUnder          |    ✅     |✅|
-| hidden   |   ✅     |    ✅        |
-| tabBadge          |       ✅    |✅|
-| currentTab by Index          |       ✅    | ✅ |
-| currentTab by componentId         |✅| ✅ |
-
-|       buttons        | iOS  | Android |
-|--------------------|:----:|:-----:|
-| id    |   ✅      |✅|
-| testID   |     ✅   |✅|
-| color             |    ✅     |✅|
-| icon          |   ✅     |✅|
-| disableTint        |    ✅       |✅|
-| fontSize        |    ✅       |✅|
-| fontWeight        |    ✅       |    /iOS Specific   |
-
-|       statusBar        | iOS  | Android |
-|--------------------|:----:|:-----:|
-| textColorScheme    |✅|[Contribute](/docs/WorkingLocally.md) |
-| textColorSchemeSingleScreen   |✅|     / iOS specific      |
-| blur             |    ✅     |      [Contribute](/docs/WorkingLocally.md)       |
-| hideWithTopBar          |   ✅     |     [Contribute](/docs/WorkingLocally.md)       |
-| hidden         |    ✅       |     [Contribute](/docs/WorkingLocally.md)      |
-
-|       other        | iOS  | Android |
-|--------------------|:----:|:-----:|
-| screenBackgroundColor        |   ✅     | ✅ |
-| orientation       |    ✅     |✅|
-| disabledBackGesture        |    ✅     |    / iOS specific     |
-| screenBackgroundImageName        |   ✅      |    [Contribute](/docs/WorkingLocally.md)        |
-| rootBackgroundImageName              |    ✅     |    [Contribute](/docs/WorkingLocally.md)       |
-| sideMenuVisible          |      ✅   |✅|
-
-
-## v1 vs v2 Feature Comparison
-Here is the full comparison of features between v1 and v2 (will be updated regularly):
-### Top Level API
-
-|    API              | v1  | v2 |
-|--------------------|-----|----|
-| startTabBasedApp   |   ✅    |   ✅  |
-| startSinglePageApp |   ✅   |  ✅   |
-| registerScreen     |   ✅   |  ✅   |
-| drawer             |    ✅  |    ✅ |
-### Screen API
-
-|  API              | v1     | v2  iOS      |	v2 Android |
-|---------------------|:--------:|:------------:|:--------------:|
-| push                |  ✅     |   ✅       |	✅		|
-| pop                 |  ✅     |  ✅        |	✅	|
-| showModal           |  ✅     |  ✅        |	✅|
-| popToRoot           |   ✅     |   ✅         |✅	|
-| resetTo             |   ✅     |    ✅        |	✅|
-| dismissModal        |   ✅     |     ✅       |	✅|
-| dismissAllModals    |   ✅     |      ✅      |	✅|
-| showContextualMenu      |   ✅     |     / Android specific       |[Contribute](/docs/WorkingLocally.md) |
-| dismissContextualMenu      |   ✅     |   / Androic specific        |[Contribute](/docs/WorkingLocally.md)  |
-| showFab      |   ✅     |    / Android specific     |✅|
-| dismissFab      |   ✅     |    / Android specific       |✅|
-| showSnackBar     |   ✅     |     / Android specific    |   [Contribute](/docs/WorkingLocally.md) |
-| dismissSnackBar     |   ✅     |    / Android specific      |  [Contribute](/docs/WorkingLocally.md) |
-| showLightBox        |   ✅     |:x:      |:x:  |
-| dismissLightBox     |   ✅     |:x:|:x: |
-| showOverlay|:x:|✅|✅|
-| dismissOverlay|:x:|✅|✅|
-| handleDeepLink      |   ✅     |       [Contribute](/docs/WorkingLocally.md)       | [Contribute](/docs/WorkingLocally.md) |
-| Screen Visibility   |   ✅     |       ✅     |✅|
-
-### Styles
-
-Note:  v1 properties with names beginning with 'navBar' are replaced in v2 with properties beginning with 'topBar' to avoid confusion with the Android native bottom nav bar.
-
-|                       | v1  | v2 iOS | v2 Android |
-|-----------------------|:--------:|:------------:|:----------|
-| topBarTextColor |   ✅    |    ✅     |     ✅        | Wix|
-| topBarTextFontSize    |   ✅    |    ✅      |     ✅        | Wix|
-| topBarTextFontFamily  |  ✅     |      ✅     |     ✅        | Wix |
-| topBarBackgroundColor |  ✅     |  ✅       |     ✅         | Wix|
-| topBarButtonColor     |  ✅     |    ✅      |✅| Wix|
-| topBarHidden          |   ✅    |   ✅      |     ✅        | Wix|
-| topBarHideOnScroll    |  ✅     |  ✅    |✅| Wix|
-| topBarTranslucent     |  ✅     |   ✅     |     [Contribute](/docs/WorkingLocally.md)        | Wix|
-| topBarTransparent     | ✅      |✅|     [Contribute](/docs/WorkingLocally.md)        |
-| topBarNoBorder        |  ✅     |    ✅     |     [Contribute](/docs/WorkingLocally.md)        |  @gtchance|
-| drawUnderTabBar       |  ✅     |    ✅     |✅| |
-| drawUnderTopBar       |  ✅     |    ✅     |✅||
-| statusBarBlur         |  ✅     |    ✅     |      [Contribute](/docs/WorkingLocally.md)       | @gtchance|
-| topBarBlur            | ✅      |    ✅     |      [Contribute](/docs/WorkingLocally.md)       | @gtchance|
-| tabBarHidden  |   ✅  |   ✅     |✅| @gtchance|
-| statusBarTextColorScheme |  ✅   |✅|      / iOS specific    |
-| statusBarTextColorSchemeSingleScreen|  ✅   |✅|     / iOS specific      |
-| topBarSubtitleColor          |  ✅   |✅|      [Contribute](/docs/WorkingLocally.md)      |
-| topBarSubtitleFontFamily    |   ✅  |✅|     [Contribute](/docs/WorkingLocally.md)       |
-| screenBackgroundColor     | ✅    |   ✅     |     [Contribute](/docs/WorkingLocally.md)       |  Wix|
-| orientation     |  ✅   |    ✅     |✅| Wix|
-| statusBarHideWithTopBar        |  ✅   |   ✅     |     [Contribute](/docs/WorkingLocally.md)       | @gtchance|
-| statusBarHidden       |  ✅   |    ✅       |     [Contribute](/docs/WorkingLocally.md)      | WIX |
-| disabledBackGesture       |   ✅  |   ✅  |    / iOS specific     |
-| screenBackgroundImageName         |   ✅  |   ✅      |    [Contribute](/docs/WorkingLocally.md)        |
-| rootBackgroundImageName            |  ✅   |    ✅     |    [Contribute](/docs/WorkingLocally.md)       |
-| setButtons          |   ✅     |    ✅    |✅| @Johan-dutoit|
-| title            |   ✅     |✅|    ✅| Wix|
-| toggleDrawer        |   ✅     |       ✅    |✅|
-| setTabBadge         |    ✅    |       ✅    |✅| Wix|
-| switchToTab         |    ✅    |       ✅   |✅|
-| topBar react component        |   ✅     |✅|✅|
-|Shared Element Transition|     :x:  |✅| [Contribute](/docs/WorkingLocally.md)|
-| splitViewScreen       |     :x:  |    [Contribute](/docs/WorkingLocally.md)      | [Contribute](/docs/WorkingLocally.md)|
-