diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/app/RootActivity.kt b/android/app-example/src/main/java/com/badoo/ribs/example/app/RootActivity.kt
index 2f4f91d14..cc443f959 100644
--- a/android/app-example/src/main/java/com/badoo/ribs/example/app/RootActivity.kt
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/app/RootActivity.kt
@@ -6,6 +6,11 @@ import android.view.ViewGroup
 import com.badoo.ribs.android.ActivityStarter
 import com.badoo.ribs.android.PermissionRequester
 import com.badoo.ribs.android.RibActivity
+import com.badoo.ribs.core.routing.action.AttachRibRoutingAction.Companion.attach
+import com.badoo.ribs.core.routing.action.RoutingAction
+import com.badoo.ribs.core.routing.portal.Portal
+import com.badoo.ribs.core.routing.portal.PortalBuilder
+import com.badoo.ribs.core.routing.portal.PortalNode
 import com.badoo.ribs.customisation.RibCustomisationDirectory
 import com.badoo.ribs.dialog.DialogLauncher
 import com.badoo.ribs.example.R
@@ -16,6 +21,7 @@ import com.badoo.ribs.example.rib.switcher.builder.SwitcherBuilder
 import com.badoo.ribs.example.util.CoffeeMachine
 import com.badoo.ribs.example.util.StupidCoffeeMachine
 import io.reactivex.Observable
+import io.reactivex.Single
 import io.reactivex.functions.BiFunction
 
 /** The sample app's single activity */
@@ -29,16 +35,31 @@ class RootActivity : RibActivity() {
     override val rootViewGroup: ViewGroup
         get() = findViewById(R.id.root)
 
-    private lateinit var workflowRoot: Switcher.Workflow
+    private lateinit var workflowRoot: Portal.Workflow
 
-    override fun createRib(savedInstanceState: Bundle?): SwitcherNode =
-        SwitcherBuilder(
-            object : Switcher.Dependency {
-                override fun ribCustomisation(): RibCustomisationDirectory = AppRibCustomisations
-                override fun activityStarter(): ActivityStarter = activityStarter
-                override fun permissionRequester(): PermissionRequester = permissionRequester
-                override fun dialogLauncher(): DialogLauncher = this@RootActivity
-                override fun coffeeMachine(): CoffeeMachine = StupidCoffeeMachine()
+    override fun createRib(savedInstanceState: Bundle?): PortalNode =
+        PortalBuilder(
+            object : Portal.Dependency {
+                override fun defaultRoutingAction(): (Portal.OtherSide) -> RoutingAction<Nothing> = { portal ->
+                    attach { buildSwitcherNode(portal, it) }
+                }
+
+                private fun buildSwitcherNode(portal: Portal.OtherSide, savedInstanceState: Bundle?): SwitcherNode {
+                    return SwitcherBuilder(
+                        object : Switcher.Dependency {
+                            override fun ribCustomisation(): RibCustomisationDirectory =
+                                AppRibCustomisations
+
+                            override fun activityStarter(): ActivityStarter = activityStarter
+                            override fun permissionRequester(): PermissionRequester =
+                                permissionRequester
+
+                            override fun dialogLauncher(): DialogLauncher = this@RootActivity
+                            override fun coffeeMachine(): CoffeeMachine = StupidCoffeeMachine()
+                            override fun portal(): Portal.OtherSide = portal
+                        }
+                    ).build(savedInstanceState)
+                }
             }
         ).build(savedInstanceState).also {
             workflowRoot = it
@@ -59,19 +80,19 @@ class RootActivity : RibActivity() {
     }
 
     private fun executeWorkflow1(): Observable<*> =
-        workflowRoot
-            .attachHelloWorld()
+        switcher()
+            .flatMap { it.attachHelloWorld()}
             .toObservable()
 
     @SuppressWarnings("OptionalUnit")
     private fun executeWorkflow2(): Observable<*> =
         Observable.combineLatest(
-            workflowRoot
-                .doSomethingAndStayOnThisNode()
+            switcher()
+                .flatMap { it.doSomethingAndStayOnThisNode() }
                 .toObservable(),
 
-            workflowRoot
-                .waitForHelloWorld()
+            switcher()
+                .flatMap { it.waitForHelloWorld() }
                 .flatMap { it.somethingSomethingDarkSide() }
                 .toObservable(),
 
@@ -79,7 +100,13 @@ class RootActivity : RibActivity() {
         )
 
     private fun executeTestCrash(): Observable<*> =
-        (rootNode as Switcher.Workflow)
-            .testCrash()
+        switcher()
+            .flatMap { it.testCrash() }
             .toObservable()
+
+    @Suppress("UNCHECKED_CAST")
+    private fun switcher() =
+        Single
+            .just(workflowRoot)
+            .flatMap { it.showDefault() as Single<Switcher.Workflow> }
 }
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/Big.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/Big.kt
new file mode 100644
index 000000000..6edf1bcac
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/Big.kt
@@ -0,0 +1,19 @@
+package com.badoo.ribs.example.rib.big
+
+import com.badoo.ribs.core.Rib
+import com.badoo.ribs.customisation.CanProvidePortal
+import com.badoo.ribs.customisation.CanProvideRibCustomisation
+import com.badoo.ribs.customisation.RibCustomisation
+
+interface Big : Rib {
+
+    interface Dependency :
+        CanProvideRibCustomisation,
+        CanProvidePortal
+
+    class Customisation(
+        val viewFactory: BigView.Factory = BigViewImpl.Factory()
+    ) : RibCustomisation
+
+    interface Workflow
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/BigInteractor.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/BigInteractor.kt
new file mode 100644
index 000000000..a44a0b87b
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/BigInteractor.kt
@@ -0,0 +1,23 @@
+package com.badoo.ribs.example.rib.big
+
+import android.arch.lifecycle.Lifecycle
+import android.os.Bundle
+import com.badoo.ribs.core.Interactor
+import com.badoo.ribs.core.Router
+import com.badoo.ribs.example.rib.big.BigRouter.Configuration
+import com.badoo.ribs.example.rib.big.BigRouter.Configuration.Content
+import com.badoo.ribs.example.rib.big.BigRouter.Configuration.Overlay
+
+class BigInteractor(
+    savedInstanceState: Bundle?,
+    router: Router<Configuration, *, Content, Overlay, BigView>
+) : Interactor<Configuration, Content, Overlay, BigView>(
+    savedInstanceState = savedInstanceState,
+    router = router,
+    disposables = null
+) {
+
+    override fun onViewCreated(view: BigView, viewLifecycle: Lifecycle) {
+        view.accept(BigView.ViewModel("My id: " + id.replace("${BigInteractor::class.java.name}.", "")))
+    }
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/BigNode.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/BigNode.kt
new file mode 100644
index 000000000..e72d9f008
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/BigNode.kt
@@ -0,0 +1,18 @@
+package com.badoo.ribs.example.rib.big
+
+import android.os.Bundle
+import android.view.ViewGroup
+import com.badoo.ribs.core.Node
+
+class BigNode(
+    savedInstanceState: Bundle?,
+    viewFactory: ((ViewGroup) -> BigView?)?,
+    private val router: BigRouter,
+    private val interactor: BigInteractor
+) : Node<BigView>(
+    savedInstanceState = savedInstanceState,
+    identifier = object : Big {},
+    viewFactory = viewFactory,
+    router = router,
+    interactor = interactor
+), Big.Workflow
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/BigRouter.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/BigRouter.kt
new file mode 100644
index 000000000..b505216b9
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/BigRouter.kt
@@ -0,0 +1,39 @@
+package com.badoo.ribs.example.rib.big
+
+import android.os.Bundle
+import android.os.Parcelable
+import com.badoo.ribs.core.Router
+import com.badoo.ribs.core.routing.action.AttachRibRoutingAction.Companion.attach
+import com.badoo.ribs.core.routing.action.RoutingAction
+import com.badoo.ribs.core.routing.action.RoutingAction.Companion.noop
+import com.badoo.ribs.example.rib.big.BigRouter.Configuration
+import com.badoo.ribs.example.rib.big.BigRouter.Configuration.Content
+import com.badoo.ribs.example.rib.big.BigRouter.Configuration.Overlay
+import com.badoo.ribs.example.rib.big.BigRouter.Configuration.Permanent
+import com.badoo.ribs.example.rib.small.builder.SmallBuilder
+import kotlinx.android.parcel.Parcelize
+
+class BigRouter(
+    savedInstanceState: Bundle?,
+    private val smallBuilder: SmallBuilder
+): Router<Configuration, Permanent, Content, Overlay, BigView>(
+    savedInstanceState = savedInstanceState,
+    initialConfiguration = Content.Default,
+    permanentParts = listOf(Permanent.Small)
+) {
+    sealed class Configuration : Parcelable {
+        sealed class Permanent : Configuration() {
+            @Parcelize object Small : Permanent()
+        }
+        sealed class Content : Configuration() {
+            @Parcelize object Default : Content()
+        }
+        sealed class Overlay : Configuration()
+    }
+
+    override fun resolveConfiguration(configuration: Configuration): RoutingAction<BigView> =
+        when (configuration) {
+            Permanent.Small -> attach { smallBuilder.build(it) }
+            Content.Default -> noop()
+        }
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/BigView.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/BigView.kt
new file mode 100644
index 000000000..4d3b7c166
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/BigView.kt
@@ -0,0 +1,61 @@
+package com.badoo.ribs.example.rib.big
+
+import android.support.annotation.LayoutRes
+import android.view.ViewGroup
+import android.widget.TextView
+import com.badoo.ribs.core.Rib
+import com.badoo.ribs.core.view.RibView
+import com.badoo.ribs.core.view.ViewFactory
+import com.badoo.ribs.customisation.inflate
+import com.badoo.ribs.example.R
+import com.badoo.ribs.example.rib.big.BigView.Event
+import com.badoo.ribs.example.rib.big.BigView.ViewModel
+import com.badoo.ribs.example.rib.small.Small
+import com.jakewharton.rxrelay2.PublishRelay
+import io.reactivex.ObservableSource
+import io.reactivex.functions.Consumer
+
+interface BigView : RibView,
+    ObservableSource<Event>,
+    Consumer<ViewModel> {
+
+    sealed class Event
+
+    data class ViewModel(
+        val text: String
+    )
+
+    interface Factory : ViewFactory<Nothing?, BigView>
+}
+
+
+class BigViewImpl private constructor(
+    override val androidView: ViewGroup,
+    private val events: PublishRelay<Event> = PublishRelay.create()
+) : BigView,
+    ObservableSource<Event> by events,
+    Consumer<ViewModel> {
+
+    class Factory(
+        @LayoutRes private val layoutRes: Int = R.layout.rib_big
+    ) : BigView.Factory {
+        override fun invoke(deps: Nothing?): (ViewGroup) -> BigView = {
+            BigViewImpl(
+                inflate(it, layoutRes)
+            )
+        }
+    }
+
+    private val idText = androidView.findViewById<TextView>(R.id.big_id)
+    private val smallContainer = androidView.findViewById<ViewGroup>(R.id.small_container)
+
+    override fun accept(vm: ViewModel) {
+        idText.text = vm.text
+    }
+
+    override fun getParentViewForChild(child: Rib): ViewGroup? =
+        when (child) {
+            is Small -> smallContainer
+            else -> null
+        }
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/builder/BigBuilder.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/builder/BigBuilder.kt
new file mode 100644
index 000000000..a2f154d3b
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/builder/BigBuilder.kt
@@ -0,0 +1,27 @@
+package com.badoo.ribs.example.rib.big.builder
+
+import android.os.Bundle
+import com.badoo.ribs.core.Builder
+import com.badoo.ribs.customisation.customisationsBranchFor
+import com.badoo.ribs.customisation.getOrDefault
+import com.badoo.ribs.example.rib.big.Big
+import com.badoo.ribs.example.rib.big.BigNode
+
+class BigBuilder(
+    dependency: Big.Dependency
+) : Builder<Big.Dependency>() {
+
+    override val dependency : Big.Dependency = object : Big.Dependency by dependency {
+        override fun ribCustomisation() = dependency.customisationsBranchFor(Big::class)
+    }
+
+    fun build(savedInstanceState: Bundle?): BigNode =
+        DaggerBigComponent
+            .factory()
+            .create(
+                dependency = dependency,
+                customisation = dependency.getOrDefault(Big.Customisation()),
+                savedInstanceState = savedInstanceState
+            )
+            .node()
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/builder/BigComponent.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/builder/BigComponent.kt
new file mode 100644
index 000000000..487af388d
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/builder/BigComponent.kt
@@ -0,0 +1,26 @@
+package com.badoo.ribs.example.rib.big.builder
+
+import android.os.Bundle
+import com.badoo.ribs.example.rib.big.Big
+import com.badoo.ribs.example.rib.big.BigNode
+import com.badoo.ribs.example.rib.small.Small
+import dagger.BindsInstance
+
+@BigScope
+@dagger.Component(
+    modules = [BigModule::class],
+    dependencies = [Big.Dependency::class]
+)
+internal interface BigComponent : Small.Dependency {
+
+    @dagger.Component.Factory
+    interface Factory {
+        fun create(
+            dependency: Big.Dependency,
+            @BindsInstance customisation: Big.Customisation,
+            @BindsInstance savedInstanceState: Bundle?
+        ): BigComponent
+    }
+
+    fun node(): BigNode
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/builder/BigModule.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/builder/BigModule.kt
new file mode 100644
index 000000000..7720efc1b
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/builder/BigModule.kt
@@ -0,0 +1,54 @@
+@file:SuppressWarnings("LongParameterList", "LongMethod")
+package com.badoo.ribs.example.rib.big.builder
+
+import android.os.Bundle
+import com.badoo.ribs.example.rib.big.Big
+import com.badoo.ribs.example.rib.big.BigInteractor
+import com.badoo.ribs.example.rib.big.BigNode
+import com.badoo.ribs.example.rib.big.BigRouter
+import com.badoo.ribs.example.rib.small.builder.SmallBuilder
+import dagger.Provides
+
+@dagger.Module
+internal object BigModule {
+
+    @BigScope
+    @Provides
+    @JvmStatic
+    internal fun router(
+        // pass component to child rib builders, or remove if there are none
+        component: BigComponent,
+        savedInstanceState: Bundle?
+    ): BigRouter =
+        BigRouter(
+            savedInstanceState = savedInstanceState,
+            smallBuilder = SmallBuilder(component)
+        )
+
+    @BigScope
+    @Provides
+    @JvmStatic
+    internal fun interactor(
+        savedInstanceState: Bundle?,
+        router: BigRouter
+    ): BigInteractor =
+        BigInteractor(
+            savedInstanceState = savedInstanceState,
+            router = router
+        )
+
+    @BigScope
+    @Provides
+    @JvmStatic
+    internal fun node(
+        savedInstanceState: Bundle?,
+        customisation: Big.Customisation,
+        router: BigRouter,
+        interactor: BigInteractor
+    ) : BigNode = BigNode(
+        savedInstanceState = savedInstanceState,
+        viewFactory = customisation.viewFactory(null),
+        router = router,
+        interactor = interactor
+    )
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/builder/BigScope.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/builder/BigScope.kt
new file mode 100644
index 000000000..ca558f739
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/big/builder/BigScope.kt
@@ -0,0 +1,7 @@
+package com.badoo.ribs.example.rib.big.builder
+
+import javax.inject.Scope
+
+@Scope
+@Retention(AnnotationRetention.RUNTIME)
+internal annotation class BigScope
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorld.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorld.kt
index 7eba94732..0f96eea71 100644
--- a/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorld.kt
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorld.kt
@@ -2,6 +2,7 @@ package com.badoo.ribs.example.rib.hello_world
 
 import com.badoo.ribs.android.CanProvideActivityStarter
 import com.badoo.ribs.core.Rib
+import com.badoo.ribs.customisation.CanProvidePortal
 import com.badoo.ribs.customisation.CanProvideRibCustomisation
 import com.badoo.ribs.customisation.RibCustomisation
 import io.reactivex.ObservableSource
@@ -10,7 +11,10 @@ import io.reactivex.functions.Consumer
 
 interface HelloWorld : Rib {
 
-    interface Dependency : CanProvideActivityStarter, CanProvideRibCustomisation {
+    interface Dependency :
+        CanProvideActivityStarter,
+        CanProvideRibCustomisation,
+        CanProvidePortal {
         fun helloWorldInput(): ObservableSource<Input>
         fun helloWorldOutput(): Consumer<Output>
     }
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorldInteractor.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorldInteractor.kt
index 69f6f6280..5243dac99 100644
--- a/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorldInteractor.kt
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorldInteractor.kt
@@ -12,6 +12,8 @@ import com.badoo.ribs.core.Interactor
 import com.badoo.ribs.core.Router
 import com.badoo.ribs.example.app.OtherActivity
 import com.badoo.ribs.example.rib.hello_world.HelloWorldRouter.Configuration
+import com.badoo.ribs.example.rib.hello_world.HelloWorldRouter.Configuration.Content
+import com.badoo.ribs.example.rib.hello_world.HelloWorldRouter.Configuration.Permanent
 import com.badoo.ribs.example.rib.hello_world.HelloWorldView.ViewModel
 import com.badoo.ribs.example.rib.hello_world.analytics.HelloWorldAnalytics
 import com.badoo.ribs.example.rib.hello_world.feature.HelloWorldFeature
@@ -24,12 +26,12 @@ import io.reactivex.functions.Consumer
 
 class HelloWorldInteractor(
     savedInstanceState: Bundle?,
-    router: Router<Configuration, Nothing, Configuration, Nothing, HelloWorldView>,
+    router: Router<Configuration, Permanent, Content, Nothing, HelloWorldView>,
     private val input: ObservableSource<HelloWorld.Input>,
     private val output: Consumer<HelloWorld.Output>,
     private val feature: HelloWorldFeature,
     private val activityStarter: ActivityStarter
-) : Interactor<Configuration, Configuration, Nothing, HelloWorldView>(
+) : Interactor<Configuration, Content, Nothing, HelloWorldView>(
     savedInstanceState = savedInstanceState,
     router = router,
     disposables = feature
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorldRouter.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorldRouter.kt
index dd79f2e12..8f286ba85 100644
--- a/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorldRouter.kt
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorldRouter.kt
@@ -1,25 +1,37 @@
 package com.badoo.ribs.example.rib.hello_world
 
+import android.os.Bundle
 import android.os.Parcelable
 import com.badoo.ribs.core.Router
+import com.badoo.ribs.core.routing.action.AttachRibRoutingAction.Companion.attach
 import com.badoo.ribs.core.routing.action.RoutingAction
 import com.badoo.ribs.core.routing.action.RoutingAction.Companion.noop
 import com.badoo.ribs.example.rib.hello_world.HelloWorldRouter.Configuration
+import com.badoo.ribs.example.rib.hello_world.HelloWorldRouter.Configuration.Content
+import com.badoo.ribs.example.rib.hello_world.HelloWorldRouter.Configuration.Permanent
+import com.badoo.ribs.example.rib.small.builder.SmallBuilder
 import kotlinx.android.parcel.Parcelize
-import android.os.Bundle
 
 class HelloWorldRouter(
-    savedInstanceState: Bundle?
-): Router<Configuration, Nothing, Configuration, Nothing, HelloWorldView>(
+    savedInstanceState: Bundle?,
+    private val smallBuilder: SmallBuilder
+): Router<Configuration, Permanent, Content, Nothing, HelloWorldView>(
     savedInstanceState = savedInstanceState,
-    initialConfiguration = Configuration.Default
+    initialConfiguration = Content.Default,
+    permanentParts = listOf(Permanent.Small)
 ) {
     sealed class Configuration : Parcelable {
-        @Parcelize object Default : Configuration()
+        sealed class Permanent : Configuration() {
+            @Parcelize object Small : Permanent()
+        }
+        sealed class Content : Configuration() {
+            @Parcelize object Default : Content()
+        }
     }
 
     override fun resolveConfiguration(configuration: Configuration): RoutingAction<HelloWorldView> =
         when (configuration) {
-            Configuration.Default -> noop()
+            Permanent.Small -> attach { smallBuilder.build(it) }
+            Content.Default -> noop()
     }
 }
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorldView.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorldView.kt
index 111f64b19..4ccd8277b 100644
--- a/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorldView.kt
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/HelloWorldView.kt
@@ -3,12 +3,14 @@ package com.badoo.ribs.example.rib.hello_world
 import android.support.annotation.LayoutRes
 import android.view.ViewGroup
 import android.widget.TextView
+import com.badoo.ribs.core.Rib
 import com.badoo.ribs.core.view.RibView
 import com.badoo.ribs.core.view.ViewFactory
 import com.badoo.ribs.customisation.inflate
 import com.badoo.ribs.example.R
 import com.badoo.ribs.example.rib.hello_world.HelloWorldView.Event
 import com.badoo.ribs.example.rib.hello_world.HelloWorldView.ViewModel
+import com.badoo.ribs.example.rib.small.Small
 import com.jakewharton.rxrelay2.PublishRelay
 import io.reactivex.ObservableSource
 import io.reactivex.functions.Consumer
@@ -47,6 +49,7 @@ class HelloWorldViewImpl private constructor(
 
     private val text: TextView = androidView.findViewById(R.id.hello_debug)
     private val launchButton: TextView = androidView.findViewById(R.id.hello_button_launch)
+    private val smallContainer: ViewGroup = androidView.findViewById(R.id.small_container)
 
     init {
         launchButton.setOnClickListener { events.accept(Event.ButtonClicked) }
@@ -55,4 +58,10 @@ class HelloWorldViewImpl private constructor(
     override fun accept(vm: ViewModel) {
         text.text = vm.text
     }
+
+    override fun getParentViewForChild(child: Rib): ViewGroup? =
+        when (child) {
+            is Small -> smallContainer
+            else -> null
+        }
 }
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/builder/HelloWorldComponent.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/builder/HelloWorldComponent.kt
index 2d351c37e..e33f73237 100644
--- a/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/builder/HelloWorldComponent.kt
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/builder/HelloWorldComponent.kt
@@ -3,6 +3,7 @@ package com.badoo.ribs.example.rib.hello_world.builder
 import android.os.Bundle
 import com.badoo.ribs.example.rib.hello_world.HelloWorld
 import com.badoo.ribs.example.rib.hello_world.HelloWorldNode
+import com.badoo.ribs.example.rib.small.Small
 import dagger.BindsInstance
 
 
@@ -11,7 +12,7 @@ import dagger.BindsInstance
     modules = [HelloWorldModule::class],
     dependencies = [HelloWorld.Dependency::class]
 )
-internal interface HelloWorldComponent {
+internal interface HelloWorldComponent : Small.Dependency {
 
     @dagger.Component.Factory
     interface Factory {
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/builder/HelloWorldModule.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/builder/HelloWorldModule.kt
index 05c8ca429..44192ef8f 100644
--- a/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/builder/HelloWorldModule.kt
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/hello_world/builder/HelloWorldModule.kt
@@ -9,6 +9,7 @@ import com.badoo.ribs.example.rib.hello_world.HelloWorldInteractor
 import com.badoo.ribs.example.rib.hello_world.HelloWorldNode
 import com.badoo.ribs.example.rib.hello_world.HelloWorldRouter
 import com.badoo.ribs.example.rib.hello_world.feature.HelloWorldFeature
+import com.badoo.ribs.example.rib.small.builder.SmallBuilder
 import dagger.Provides
 import io.reactivex.ObservableSource
 import io.reactivex.functions.Consumer
@@ -20,10 +21,12 @@ internal object HelloWorldModule {
     @Provides
     @JvmStatic
     internal fun router(
+        component: HelloWorldComponent,
         savedInstanceState: Bundle?
     ): HelloWorldRouter =
         HelloWorldRouter(
-            savedInstanceState = savedInstanceState
+            savedInstanceState = savedInstanceState,
+            smallBuilder = SmallBuilder(component)
         )
 
     @HelloWorldScope
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/Small.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/Small.kt
new file mode 100644
index 000000000..b6ac795e4
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/Small.kt
@@ -0,0 +1,19 @@
+package com.badoo.ribs.example.rib.small
+
+import com.badoo.ribs.core.Rib
+import com.badoo.ribs.customisation.CanProvidePortal
+import com.badoo.ribs.customisation.CanProvideRibCustomisation
+import com.badoo.ribs.customisation.RibCustomisation
+
+interface Small : Rib {
+
+    interface Dependency :
+        CanProvideRibCustomisation,
+        CanProvidePortal
+
+    class Customisation(
+        val viewFactory: SmallView.Factory = SmallViewImpl.Factory()
+    ) : RibCustomisation
+
+    interface Workflow
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/SmallInteractor.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/SmallInteractor.kt
new file mode 100644
index 000000000..92ddcc4d6
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/SmallInteractor.kt
@@ -0,0 +1,37 @@
+package com.badoo.ribs.example.rib.small
+
+import android.arch.lifecycle.Lifecycle
+import android.os.Bundle
+import com.badoo.mvicore.android.lifecycle.createDestroy
+import com.badoo.ribs.core.Interactor
+import com.badoo.ribs.core.Router
+import com.badoo.ribs.core.routing.portal.Portal
+import com.badoo.ribs.example.rib.small.SmallRouter.Configuration
+import com.badoo.ribs.example.rib.small.SmallRouter.Configuration.Content
+import com.badoo.ribs.example.rib.small.SmallRouter.Configuration.FullScreen
+import com.badoo.ribs.example.rib.small.SmallView.Event
+import com.badoo.ribs.example.rib.small.SmallView.ViewModel
+import io.reactivex.functions.Consumer
+
+class SmallInteractor(
+    portal: Portal.OtherSide,
+    savedInstanceState: Bundle?,
+    router: Router<Configuration, *, Content, Nothing, SmallView>
+) : Interactor<Configuration, Content, Nothing, SmallView>(
+    savedInstanceState = savedInstanceState,
+    router = router,
+    disposables = null
+) {
+    override fun onViewCreated(view: SmallView, viewLifecycle: Lifecycle) {
+        view.accept(ViewModel("My id: " + id.replace("${SmallInteractor::class.java.name}.", "")))
+        viewLifecycle.createDestroy {
+            bind(view to viewEventConsumer)
+        }
+    }
+
+    private val viewEventConsumer: Consumer<Event> = Consumer {
+        when (it) {
+            Event.OpenBigClicked -> portal.showRemote(router, FullScreen.ShowBig)
+        }
+    }
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/SmallNode.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/SmallNode.kt
new file mode 100644
index 000000000..6caf443f5
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/SmallNode.kt
@@ -0,0 +1,20 @@
+package com.badoo.ribs.example.rib.small
+
+import android.os.Bundle
+import android.view.ViewGroup
+import com.badoo.ribs.core.Node
+
+class SmallNode(
+    savedInstanceState: Bundle?,
+    viewFactory: ((ViewGroup) -> SmallView?)?,
+    private val router: SmallRouter,
+    private val interactor: SmallInteractor
+) : Node<SmallView>(
+    savedInstanceState = savedInstanceState,
+    identifier = object : Small {},
+    viewFactory = viewFactory,
+    router = router,
+    interactor = interactor
+), Small.Workflow {
+
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/SmallRouter.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/SmallRouter.kt
new file mode 100644
index 000000000..3f3f0cb83
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/SmallRouter.kt
@@ -0,0 +1,37 @@
+package com.badoo.ribs.example.rib.small
+
+import android.os.Bundle
+import android.os.Parcelable
+import com.badoo.ribs.core.Router
+import com.badoo.ribs.core.routing.action.AnchoredAttachRoutingAction.Companion.anchor
+import com.badoo.ribs.core.routing.action.RoutingAction
+import com.badoo.ribs.core.routing.action.RoutingAction.Companion.noop
+import com.badoo.ribs.example.rib.big.builder.BigBuilder
+import com.badoo.ribs.example.rib.small.SmallRouter.Configuration
+import com.badoo.ribs.example.rib.small.SmallRouter.Configuration.Content
+import com.badoo.ribs.example.rib.small.SmallRouter.Configuration.FullScreen
+import kotlinx.android.parcel.Parcelize
+
+class SmallRouter(
+    savedInstanceState: Bundle?,
+    private val bigBuilder: BigBuilder
+): Router<Configuration, Nothing, Content, Nothing, SmallView>(
+    savedInstanceState = savedInstanceState,
+    initialConfiguration = Content.Default,
+    permanentParts = emptyList()
+) {
+    sealed class Configuration : Parcelable {
+        sealed class Content : Configuration() {
+            @Parcelize object Default : Content()
+        }
+        sealed class FullScreen : Configuration() {
+            @Parcelize object ShowBig : FullScreen()
+        }
+    }
+
+    override fun resolveConfiguration(configuration: Configuration): RoutingAction<SmallView> =
+        when (configuration) {
+            Content.Default -> noop()
+            FullScreen.ShowBig -> anchor(node) { bigBuilder.build(it) }
+        }
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/SmallView.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/SmallView.kt
new file mode 100644
index 000000000..cd3be80f8
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/SmallView.kt
@@ -0,0 +1,58 @@
+package com.badoo.ribs.example.rib.small
+
+import android.support.annotation.LayoutRes
+import android.view.ViewGroup
+import android.widget.Button
+import android.widget.TextView
+import com.badoo.ribs.core.view.RibView
+import com.badoo.ribs.core.view.ViewFactory
+import com.badoo.ribs.example.R
+import com.badoo.ribs.example.rib.small.SmallView.Event
+import com.badoo.ribs.example.rib.small.SmallView.ViewModel
+import com.jakewharton.rxrelay2.PublishRelay
+import io.reactivex.ObservableSource
+import io.reactivex.functions.Consumer
+
+interface SmallView : RibView,
+    ObservableSource<Event>,
+    Consumer<ViewModel> {
+
+    sealed class Event {
+        object OpenBigClicked : Event()
+    }
+
+    data class ViewModel(
+        val text: String
+    )
+
+    interface Factory : ViewFactory<Nothing?, SmallView>
+}
+
+
+class SmallViewImpl private constructor(
+    override val androidView: ViewGroup,
+    private val events: PublishRelay<Event> = PublishRelay.create()
+) : SmallView,
+    ObservableSource<Event> by events {
+
+    class Factory(
+        @LayoutRes private val layoutRes: Int = R.layout.rib_small
+    ) : SmallView.Factory {
+        override fun invoke(deps: Nothing?): (ViewGroup) -> SmallView = {
+            SmallViewImpl(
+                com.badoo.ribs.customisation.inflate(it, layoutRes)
+            )
+        }
+    }
+
+    private val idText = androidView.findViewById<TextView>(R.id.small_id)
+    private val openBigButton = androidView.findViewById<Button>(R.id.open_big)
+
+    init {
+        openBigButton.setOnClickListener { events.accept(Event.OpenBigClicked)  }
+    }
+
+    override fun accept(vm: ViewModel) {
+        idText.text = vm.text
+    }
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/builder/SmallBuilder.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/builder/SmallBuilder.kt
new file mode 100644
index 000000000..7d080f91c
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/builder/SmallBuilder.kt
@@ -0,0 +1,27 @@
+package com.badoo.ribs.example.rib.small.builder
+
+import android.os.Bundle
+import com.badoo.ribs.core.Builder
+import com.badoo.ribs.customisation.customisationsBranchFor
+import com.badoo.ribs.customisation.getOrDefault
+import com.badoo.ribs.example.rib.small.Small
+import com.badoo.ribs.example.rib.small.SmallNode
+
+class SmallBuilder(
+    dependency: Small.Dependency
+) : Builder<Small.Dependency>() {
+
+    override val dependency : Small.Dependency = object : Small.Dependency by dependency {
+        override fun ribCustomisation() = dependency.customisationsBranchFor(Small::class)
+    }
+
+    fun build(savedInstanceState: Bundle?): SmallNode =
+        DaggerSmallComponent
+            .factory()
+            .create(
+                dependency = dependency,
+                customisation = dependency.getOrDefault(Small.Customisation()),
+                savedInstanceState = savedInstanceState
+            )
+            .node()
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/builder/SmallComponent.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/builder/SmallComponent.kt
new file mode 100644
index 000000000..8a38db0de
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/builder/SmallComponent.kt
@@ -0,0 +1,26 @@
+package com.badoo.ribs.example.rib.small.builder
+
+import android.os.Bundle
+import com.badoo.ribs.example.rib.big.Big
+import com.badoo.ribs.example.rib.small.Small
+import com.badoo.ribs.example.rib.small.SmallNode
+import dagger.BindsInstance
+
+@SmallScope
+@dagger.Component(
+    modules = [SmallModule::class],
+    dependencies = [Small.Dependency::class]
+)
+internal interface SmallComponent : Big.Dependency {
+
+    @dagger.Component.Factory
+    interface Factory {
+        fun create(
+            dependency: Small.Dependency,
+            @BindsInstance customisation: Small.Customisation,
+            @BindsInstance savedInstanceState: Bundle?
+        ): SmallComponent
+    }
+
+    fun node(): SmallNode
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/builder/SmallModule.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/builder/SmallModule.kt
new file mode 100644
index 000000000..adec185b1
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/builder/SmallModule.kt
@@ -0,0 +1,57 @@
+@file:SuppressWarnings("LongParameterList", "LongMethod")
+package com.badoo.ribs.example.rib.small.builder
+
+import android.os.Bundle
+import com.badoo.ribs.core.routing.portal.Portal
+import com.badoo.ribs.example.rib.big.builder.BigBuilder
+import com.badoo.ribs.example.rib.small.Small
+import com.badoo.ribs.example.rib.small.SmallInteractor
+import com.badoo.ribs.example.rib.small.SmallNode
+import com.badoo.ribs.example.rib.small.SmallRouter
+import dagger.Provides
+
+@dagger.Module
+internal object SmallModule {
+
+    @SmallScope
+    @Provides
+    @JvmStatic
+    internal fun router(
+        // pass component to child rib builders, or remove if there are none
+        component: SmallComponent,
+        savedInstanceState: Bundle?
+    ): SmallRouter =
+        SmallRouter(
+            savedInstanceState = savedInstanceState,
+            bigBuilder = BigBuilder(component)
+        )
+
+    @SmallScope
+    @Provides
+    @JvmStatic
+    internal fun interactor(
+        savedInstanceState: Bundle?,
+        router: SmallRouter,
+        portal: Portal.OtherSide
+    ): SmallInteractor =
+        SmallInteractor(
+            savedInstanceState = savedInstanceState,
+            router = router,
+            portal = portal
+        )
+
+    @SmallScope
+    @Provides
+    @JvmStatic
+    internal fun node(
+        savedInstanceState: Bundle?,
+        customisation: Small.Customisation,
+        router: SmallRouter,
+        interactor: SmallInteractor
+    ) : SmallNode = SmallNode(
+        savedInstanceState = savedInstanceState,
+        viewFactory = customisation.viewFactory(null),
+        router = router,
+        interactor = interactor
+    )
+}
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/builder/SmallScope.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/builder/SmallScope.kt
new file mode 100644
index 000000000..ea759f373
--- /dev/null
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/small/builder/SmallScope.kt
@@ -0,0 +1,7 @@
+package com.badoo.ribs.example.rib.small.builder
+
+import javax.inject.Scope
+
+@Scope
+@Retention(AnnotationRetention.RUNTIME)
+internal annotation class SmallScope
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/switcher/Switcher.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/switcher/Switcher.kt
index de2a96241..16bcb9d79 100644
--- a/android/app-example/src/main/java/com/badoo/ribs/example/rib/switcher/Switcher.kt
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/switcher/Switcher.kt
@@ -3,6 +3,7 @@ package com.badoo.ribs.example.rib.switcher
 import com.badoo.ribs.android.CanProvideActivityStarter
 import com.badoo.ribs.android.CanProvidePermissionRequester
 import com.badoo.ribs.core.Rib
+import com.badoo.ribs.customisation.CanProvidePortal
 import com.badoo.ribs.customisation.CanProvideRibCustomisation
 import com.badoo.ribs.customisation.RibCustomisation
 import com.badoo.ribs.dialog.CanProvideDialogLauncher
@@ -16,7 +17,8 @@ interface Switcher : Rib {
         CanProvideActivityStarter,
         CanProvidePermissionRequester,
         CanProvideDialogLauncher,
-        CanProvideRibCustomisation {
+        CanProvideRibCustomisation,
+        CanProvidePortal {
 
         fun coffeeMachine(): CoffeeMachine
     }
diff --git a/android/app-example/src/main/java/com/badoo/ribs/example/rib/switcher/SwitcherInteractor.kt b/android/app-example/src/main/java/com/badoo/ribs/example/rib/switcher/SwitcherInteractor.kt
index e514703c1..e64d0a460 100644
--- a/android/app-example/src/main/java/com/badoo/ribs/example/rib/switcher/SwitcherInteractor.kt
+++ b/android/app-example/src/main/java/com/badoo/ribs/example/rib/switcher/SwitcherInteractor.kt
@@ -25,6 +25,7 @@ class SwitcherInteractor(
     router = router,
     disposables = null
 ) {
+
     override fun onViewCreated(view: SwitcherView, viewLifecycle: Lifecycle) {
         super.onViewCreated(view, viewLifecycle)
         viewLifecycle.createDestroy {
diff --git a/android/app-example/src/main/res/layout/rib_big.xml b/android/app-example/src/main/res/layout/rib_big.xml
new file mode 100644
index 000000000..cdb41caec
--- /dev/null
+++ b/android/app-example/src/main/res/layout/rib_big.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:id="@+id/rib_big"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:orientation="vertical"
+    android:layout_gravity="center"
+    android:gravity="center">
+
+    <TextView
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="This should be displayed full screen" />
+
+    <TextView
+        android:id="@+id/big_id"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content" />
+
+    <FrameLayout
+        android:id="@+id/small_container"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="24dp" />
+
+</LinearLayout>
diff --git a/android/app-example/src/main/res/layout/rib_hello_world.xml b/android/app-example/src/main/res/layout/rib_hello_world.xml
index a38a4e6bc..fef9ab86c 100644
--- a/android/app-example/src/main/res/layout/rib_hello_world.xml
+++ b/android/app-example/src/main/res/layout/rib_hello_world.xml
@@ -36,8 +36,18 @@
         android:layout_width="wrap_content"
         android:layout_height="wrap_content"
         android:text="@string/launch_other_activity"
-        android:layout_marginTop="24dp"
+        android:layout_margin="24dp"
         app:layout_constraintTop_toBottomOf="@id/hello_debug"
+        app:layout_constraintBottom_toTopOf="@id/small_container"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintEnd_toEndOf="parent" />
+
+    <FrameLayout
+        android:id="@+id/small_container"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_marginTop="24dp"
+        app:layout_constraintTop_toBottomOf="@id/hello_button_launch"
         app:layout_constraintBottom_toBottomOf="parent"
         app:layout_constraintStart_toStartOf="parent"
         app:layout_constraintEnd_toEndOf="parent" />
diff --git a/android/app-example/src/main/res/layout/rib_small.xml b/android/app-example/src/main/res/layout/rib_small.xml
new file mode 100644
index 000000000..588a9f55b
--- /dev/null
+++ b/android/app-example/src/main/res/layout/rib_small.xml
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    android:id="@+id/rib_small"
+    android:layout_width="match_parent"
+    android:layout_height="match_parent"
+    android:background="#999"
+    android:padding="24dp"
+    android:orientation="vertical"
+    android:layout_gravity="center"
+    android:gravity="center">
+
+    <TextView
+        android:id="@+id/small_id"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"/>
+
+    <Button
+        android:id="@+id/open_big"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:text="Open Big"/>
+
+</LinearLayout>
diff --git a/android/app-example/src/test/java/com/badoo/ribs/example/rib/test/MainScreenTest.kt b/android/app-example/src/test/java/com/badoo/ribs/example/rib/test/MainScreenTest.kt
index f1908a841..4d52499c0 100644
--- a/android/app-example/src/test/java/com/badoo/ribs/example/rib/test/MainScreenTest.kt
+++ b/android/app-example/src/test/java/com/badoo/ribs/example/rib/test/MainScreenTest.kt
@@ -7,6 +7,7 @@ import android.view.ViewGroup
 import com.badoo.ribs.android.CanProvideActivityStarter
 import com.badoo.ribs.android.CanProvidePermissionRequester
 import com.badoo.ribs.core.Node
+import com.badoo.ribs.customisation.CanProvidePortal
 import com.badoo.ribs.customisation.RibCustomisationDirectory
 import com.badoo.ribs.customisation.RibCustomisationDirectoryImpl
 import com.badoo.ribs.dialog.CanProvideDialogLauncher
@@ -93,7 +94,8 @@ class MainScreenTest {
         SwitcherBuilder(object : Switcher.Dependency,
             CanProvideActivityStarter by dependencies,
             CanProvidePermissionRequester by dependencies,
-            CanProvideDialogLauncher by dependencies {
+            CanProvideDialogLauncher by dependencies,
+            CanProvidePortal by dependencies {
 
             override fun coffeeMachine(): CoffeeMachine =
                 mock()
diff --git a/android/app-example/src/test/java/com/badoo/ribs/example/rib/util/TestDefaultDependencies.kt b/android/app-example/src/test/java/com/badoo/ribs/example/rib/util/TestDefaultDependencies.kt
index 76d53fe98..e486255af 100644
--- a/android/app-example/src/test/java/com/badoo/ribs/example/rib/util/TestDefaultDependencies.kt
+++ b/android/app-example/src/test/java/com/badoo/ribs/example/rib/util/TestDefaultDependencies.kt
@@ -3,6 +3,8 @@ package com.badoo.ribs.example.rib.util
 import com.badoo.ribs.android.ActivityStarter
 import com.badoo.ribs.android.CanProvideActivityStarter
 import com.badoo.ribs.android.CanProvidePermissionRequester
+import com.badoo.ribs.core.routing.portal.Portal
+import com.badoo.ribs.customisation.CanProvidePortal
 import com.badoo.ribs.customisation.CanProvideRibCustomisation
 import com.badoo.ribs.customisation.RibCustomisationDirectory
 import com.badoo.ribs.customisation.RibCustomisationDirectoryImpl
@@ -14,7 +16,8 @@ class TestDefaultDependencies :
     CanProvideActivityStarter,
     CanProvidePermissionRequester,
     CanProvideDialogLauncher,
-    CanProvideRibCustomisation {
+    CanProvideRibCustomisation,
+    CanProvidePortal {
 
     val permissionRequester = TestPermissionRequester()
     val activityStarter = TestActivityStarter()
@@ -23,4 +26,5 @@ class TestDefaultDependencies :
     override fun permissionRequester() = permissionRequester
     override fun activityStarter(): ActivityStarter = activityStarter
     override fun dialogLauncher(): DialogLauncher = mock()
+    override fun portal(): Portal.OtherSide = mock()
 }
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/Node.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/Node.kt
index 3fd036f07..9be65798f 100644
--- a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/Node.kt
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/Node.kt
@@ -34,6 +34,8 @@ import android.support.annotation.MainThread
 import android.support.annotation.VisibleForTesting
 import android.util.SparseArray
 import android.view.ViewGroup
+import com.badoo.ribs.core.routing.configuration.ConfigurationResolver
+import com.badoo.ribs.core.routing.portal.AncestryInfo
 import com.badoo.ribs.core.view.RibView
 import com.badoo.ribs.util.RIBs
 import com.jakewharton.rxrelay2.BehaviorRelay
@@ -41,7 +43,6 @@ import com.jakewharton.rxrelay2.PublishRelay
 import com.uber.rib.util.RibRefWatcher
 import io.reactivex.Observable
 import io.reactivex.Single
-import java.lang.IllegalStateException
 import java.util.concurrent.CopyOnWriteArrayList
 
 /**
@@ -57,9 +58,7 @@ open class Node<V : RibView>(
     private val ribRefWatcher: RibRefWatcher = RibRefWatcher.getInstance()
 ) : LifecycleOwner {
 
-    private val savedInstanceState = savedInstanceState?.getBundle(BUNDLE_KEY)
-
-    enum class ViewAttachMode {
+    enum class AttachMode {
         /**
          * The node's view attach/detach is managed by its parent.
          */
@@ -77,7 +76,7 @@ open class Node<V : RibView>(
 
     data class Descriptor(
         val node: Node<*>,
-        val viewAttachMode: ViewAttachMode
+        val viewAttachMode: AttachMode
     )
 
     companion object {
@@ -85,6 +84,17 @@ open class Node<V : RibView>(
         internal const val KEY_VIEW_STATE = "view.state"
     }
 
+    /**
+     * FIXME the proper solution is to set this in constructor (pack it with savedInstanceState)
+     * If left like this, it's not guaranteed to be set correctly, and can lead to problems
+     * Proposed solution would mean passing Root only at integration point, Child is used automatically
+     * by building mechanism.
+     * Also PortalRouter.Configuration.Portal can then work directly with a @Parcelize AncestryInfo,
+     * which is not currently possible.
+     */
+    var ancestryInfo: AncestryInfo = AncestryInfo.Root
+    val resolver: ConfigurationResolver<*, V> = router
+    private val savedInstanceState = savedInstanceState?.getBundle(BUNDLE_KEY)
     private val externalLifecycleRegistry = LifecycleRegistry(this)
     internal val ribLifecycleRegistry = LifecycleRegistry(this)
     internal val viewLifecycleRegistry = LifecycleRegistry(this)
@@ -124,6 +134,7 @@ open class Node<V : RibView>(
     }
 
     open fun attachToView(parentViewGroup: ViewGroup) {
+        detachFromView()
         this.parentViewGroup = parentViewGroup
         isAttachedToView = true
 
@@ -191,22 +202,23 @@ open class Node<V : RibView>(
      * @param childNode the [Node] to be attached.
      */
     @MainThread
-    internal fun attachChildNode(childNode: Node<*>) {
-        children.add(childNode)
+    internal fun attachChildNode(child: Node<*>) {
+        children.add(child)
         ribRefWatcher.logBreadcrumb(
-            "ATTACHED", childNode.javaClass.simpleName, this.javaClass.simpleName
+            "ATTACHED", child.javaClass.simpleName, this.javaClass.simpleName
         )
 
-        childNode.inheritExternalLifecycle(externalLifecycleRegistry)
-        childNode.onAttach()
-        childrenAttachesRelay.accept(childNode)
+        child.inheritExternalLifecycle(externalLifecycleRegistry)
+        child.onAttach()
+        childrenAttachesRelay.accept(child)
     }
 
     private fun inheritExternalLifecycle(lifecycleRegistry: LifecycleRegistry) {
         externalLifecycleRegistry.markState(lifecycleRegistry.currentState)
     }
 
-    internal fun attachChildView(child: Node<*>) {
+    // FIXME internal + protected?
+    fun attachChildView(child: Node<*>) {
         if (isAttachedToView) {
             val target = when {
                 // parentViewGroup is guaranteed to be non-null if and only if view is attached
@@ -218,7 +230,8 @@ open class Node<V : RibView>(
         }
     }
 
-    internal fun detachChildView(child: Node<*>) {
+    // FIXME internal + protected?
+    fun detachChildView(child: Node<*>) {
         parentViewGroup?.let {
             child.detachFromView()
         }
@@ -358,7 +371,7 @@ open class Node<V : RibView>(
         ribLifecycleRegistry
 
     override fun toString(): String =
-        "Node@${hashCode()} ($identifier)"
+        identifier.toString()
 
     /**
      * Executes an action and remains on the same hierarchical level
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/Router.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/Router.kt
index 65d53d959..e587a7312 100644
--- a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/Router.kt
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/Router.kt
@@ -4,10 +4,10 @@ import android.os.Bundle
 import android.os.Parcelable
 import com.badoo.mvicore.android.AndroidTimeCapsule
 import com.badoo.mvicore.binder.Binder
-import com.badoo.ribs.core.routing.action.RoutingAction
 import com.badoo.ribs.core.routing.configuration.ConfigurationCommand.MultiConfigurationCommand.SaveInstanceState
 import com.badoo.ribs.core.routing.configuration.ConfigurationCommand.MultiConfigurationCommand.Sleep
 import com.badoo.ribs.core.routing.configuration.ConfigurationCommand.MultiConfigurationCommand.WakeUp
+import com.badoo.ribs.core.routing.configuration.ConfigurationResolver
 import com.badoo.ribs.core.routing.configuration.feature.BackStackFeature
 import com.badoo.ribs.core.routing.configuration.feature.BackStackFeature.Operation.NewRoot
 import com.badoo.ribs.core.routing.configuration.feature.BackStackFeature.Operation.Pop
@@ -22,7 +22,7 @@ abstract class Router<C : Parcelable, Permanent : C, Content : C, Overlay : C, V
     savedInstanceState: Bundle?,
     private val initialConfiguration: Content,
     private val permanentParts: List<Permanent> = emptyList()
-) {
+) : ConfigurationResolver<C, V> {
     companion object {
         internal const val BUNDLE_KEY = "Router"
     }
@@ -54,8 +54,6 @@ abstract class Router<C : Parcelable, Permanent : C, Content : C, Overlay : C, V
         )
     }
 
-    abstract fun resolveConfiguration(configuration: C): RoutingAction<V>
-
     fun onSaveInstanceState(outState: Bundle) {
         configurationFeature.accept(SaveInstanceState())
         val bundle = Bundle()
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/AnchoredAttachRoutingAction.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/AnchoredAttachRoutingAction.kt
new file mode 100644
index 000000000..7f727573a
--- /dev/null
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/AnchoredAttachRoutingAction.kt
@@ -0,0 +1,26 @@
+package com.badoo.ribs.core.routing.action
+
+import android.os.Bundle
+import com.badoo.ribs.core.Node
+import com.badoo.ribs.core.view.RibView
+
+class AnchoredAttachRoutingAction<V : RibView>(
+    private val anchor: Node<*>,
+    builder: (Bundle?) -> Node<*>
+) : AttachRibRoutingAction<V>(
+    builder = builder
+) {
+
+    override fun anchor(): Node<*>? =
+        anchor
+
+    companion object {
+        fun <V : RibView> anchor(
+            anchor: Node<*>,
+            builder: (Bundle?) -> Node<*>): RoutingAction<V> =
+            AnchoredAttachRoutingAction(
+                anchor,
+                builder
+            )
+    }
+}
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/AttachRibRoutingAction.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/AttachRibRoutingAction.kt
index 26713c0de..e542ad0e8 100644
--- a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/AttachRibRoutingAction.kt
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/AttachRibRoutingAction.kt
@@ -4,7 +4,7 @@ import android.os.Bundle
 import com.badoo.ribs.core.Node
 import com.badoo.ribs.core.view.RibView
 
-class AttachRibRoutingAction<V : RibView>(
+open class AttachRibRoutingAction<V : RibView>(
     private val builder: (Bundle?) -> Node<*>
 ) : RoutingAction<V> {
 
@@ -12,7 +12,7 @@ class AttachRibRoutingAction<V : RibView>(
         listOf(
             Node.Descriptor(
                 node = builder.invoke(bundles.firstOrNull()),
-                viewAttachMode = Node.ViewAttachMode.PARENT
+                viewAttachMode = Node.AttachMode.PARENT
             )
         )
 
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/DialogRoutingAction.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/DialogRoutingAction.kt
index 0c02c44f4..5e8bae1a4 100644
--- a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/DialogRoutingAction.kt
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/DialogRoutingAction.kt
@@ -2,7 +2,7 @@ package com.badoo.ribs.core.routing.action
 
 import android.os.Bundle
 import com.badoo.ribs.core.Node
-import com.badoo.ribs.core.Node.ViewAttachMode
+import com.badoo.ribs.core.Node.AttachMode
 import com.badoo.ribs.core.Router
 import com.badoo.ribs.core.view.RibView
 import com.badoo.ribs.dialog.Dialog
@@ -16,7 +16,7 @@ class DialogRoutingAction<V : RibView, Event : Any>(
 
     override fun buildNodes(bundles: List<Bundle?>) : List<Node.Descriptor> =
         dialog.buildNodes(bundles).map {
-            Node.Descriptor(it, ViewAttachMode.EXTERNAL)
+            Node.Descriptor(it, AttachMode.EXTERNAL)
         }
 
     override fun execute() {
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/RoutingAction.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/RoutingAction.kt
index d651bc358..0fd53435c 100644
--- a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/RoutingAction.kt
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/action/RoutingAction.kt
@@ -13,9 +13,12 @@ interface RoutingAction<V : RibView> {
 
     }
 
-    fun cleanup()  {
+    fun cleanup() {
     }
 
+    fun anchor(): Node<*>? =
+        null
+
     companion object {
         fun <V : RibView> noop(): RoutingAction<V> = object :
             RoutingAction<V> {}
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/ConfigurationContext.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/ConfigurationContext.kt
index 7f24b2713..3df4e5dba 100644
--- a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/ConfigurationContext.kt
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/ConfigurationContext.kt
@@ -5,6 +5,7 @@ import android.os.Parcelable
 import com.badoo.ribs.core.Node
 import com.badoo.ribs.core.routing.action.RoutingAction
 import com.badoo.ribs.core.routing.configuration.ConfigurationContext.ActivationState.ACTIVE
+import com.badoo.ribs.core.routing.portal.AncestryInfo
 import kotlinx.android.parcel.Parcelize
 
 /**
@@ -87,31 +88,41 @@ internal sealed class ConfigurationContext<C : Parcelable> {
         }
 
         /**
-         * Resolves and sets the associated [RoutingAction], builds associated [Node]s, and adds
-         * them to the [parentNode]
+         * Resolves and sets the associated [RoutingAction], builds associated [Node]s
          */
         override fun resolve(
             resolver: (C) -> RoutingAction<*>,
             parentNode: Node<*>,
             onResolution: (Resolved<C>) -> Resolved<C>
         ): Resolved<C> {
-            bundles.forEach {
-                it.classLoader = ConfigurationContext::class.java.classLoader
-            }
-
+            bundles.forEach { it.classLoader = ConfigurationContext::class.java.classLoader }
             val routingAction = resolver.invoke(configuration)
-
             return onResolution.invoke(
                 Resolved(
                     activationState = activationState,
                     configuration = configuration,
                     bundles = bundles,
                     routingAction = routingAction,
-                    nodes = routingAction.buildNodes(bundles)
+                    nodes = routingAction.buildNodes(bundles).also {
+                        setAncestryInfo(it, routingAction, parentNode)
+                    }
                 )
             )
         }
 
+        private fun setAncestryInfo(
+            descriptors: List<Node.Descriptor>,
+            routingAction: RoutingAction<*>,
+            parentNode: Node<*>
+        ) {
+            descriptors.forEach {
+                it.node.ancestryInfo = AncestryInfo.Child(
+                    anchor = routingAction.anchor() ?: parentNode,
+                    creatorConfiguration = configuration
+                )
+            }
+        }
+
         override fun sleep(): Unresolved<C> = copy(
             activationState = activationState.sleep()
         )
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/ConfigurationResolver.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/ConfigurationResolver.kt
new file mode 100644
index 000000000..2f61192af
--- /dev/null
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/ConfigurationResolver.kt
@@ -0,0 +1,9 @@
+package com.badoo.ribs.core.routing.configuration
+
+import android.os.Parcelable
+import com.badoo.ribs.core.routing.action.RoutingAction
+import com.badoo.ribs.core.view.RibView
+
+interface ConfigurationResolver<C : Parcelable, V : RibView> {
+    fun resolveConfiguration(configuration: C): RoutingAction<V>
+}
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/action/single/ActivateAction.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/action/single/ActivateAction.kt
index 6292c4cd8..fe18f93a2 100644
--- a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/action/single/ActivateAction.kt
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/action/single/ActivateAction.kt
@@ -25,7 +25,7 @@ internal object ActivateAction : ResolvedSingleConfigurationAction() {
         val (_, parentNode, globalActivationLevel) = params
 
         // If there's no view available (i.e. globalActivationLevel == SLEEPING) we must not execute
-        // routing actions or try to attach view. That will be done on next WakeUp. For not, let's
+        // routing actions or try to attach view. That will be done on next WakeUp. For now, let's
         // just mark the element to the same value.
         if (globalActivationLevel != ACTIVE) {
             return item.withActivationState(globalActivationLevel)
@@ -43,7 +43,7 @@ internal object ActivateAction : ResolvedSingleConfigurationAction() {
 
     private fun Node<*>.attachParentedViews(nodes: List<Node.Descriptor>) {
         nodes.forEach {
-            if (it.viewAttachMode == Node.ViewAttachMode.PARENT && !it.node.isAttachedToView) {
+            if (it.viewAttachMode == Node.AttachMode.PARENT && !it.node.isAttachedToView) {
                 attachChildView(it.node)
             }
         }
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/action/single/DeactivateAction.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/action/single/DeactivateAction.kt
index 868f7bccf..66094e7ba 100644
--- a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/action/single/DeactivateAction.kt
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/configuration/action/single/DeactivateAction.kt
@@ -31,7 +31,7 @@ internal object DeactivateAction : ResolvedSingleConfigurationAction() {
 
     private fun Node<*>.detachChildViews(nodes: List<Node.Descriptor>) {
         nodes.forEach {
-            if (it.viewAttachMode == Node.ViewAttachMode.PARENT) {
+            if (it.viewAttachMode == Node.AttachMode.PARENT) {
                 detachChildView(it.node)
             }
         }
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/AncestryInfo.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/AncestryInfo.kt
new file mode 100644
index 000000000..62c969b8b
--- /dev/null
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/AncestryInfo.kt
@@ -0,0 +1,42 @@
+package com.badoo.ribs.core.routing.portal
+
+import android.os.Parcelable
+import com.badoo.ribs.core.Node
+
+sealed class AncestryInfo {
+
+    /**
+     * The whole chain of Configurations that can be used to reach this [Node]
+     */
+    abstract val configurationChain: List<Parcelable>
+
+    /**
+     * Represents ancestry info of a [Node] that is a root of a tree and doesn't have any parents
+     */
+    object Root : AncestryInfo() {
+        override var configurationChain: List<Parcelable> = emptyList()
+    }
+
+    /**
+     * Represents ancestry info of a [Node] that is attached to a parent
+     */
+    data class Child(
+        /**
+         * The virtual parent of the current [Node]. In most cases it is the same as the actual parent,
+         * however, it is different e.g. in the case of full screen [Portal]s: the actual parent is the
+         * portal host Node, while the anchor refers to the [Node] that initiated building and adding
+         * the current one to the [Portal].
+         */
+        val anchor: Node<*>,
+
+        /**
+         * The Configuration the parent [Node] was set to that resulted in the creation of this [Node].
+         * Used in [configurationChain] for [Portal] resolution.
+         */
+        val creatorConfiguration: Parcelable
+    ) : AncestryInfo() {
+
+        override val configurationChain: List<Parcelable>
+            get() = anchor.ancestryInfo.configurationChain + creatorConfiguration
+    }
+}
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/Portal.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/Portal.kt
new file mode 100644
index 000000000..bb657b3f1
--- /dev/null
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/Portal.kt
@@ -0,0 +1,24 @@
+package com.badoo.ribs.core.routing.portal
+
+import android.os.Parcelable
+import com.badoo.ribs.core.Node
+import com.badoo.ribs.core.Rib
+import com.badoo.ribs.core.Router
+import com.badoo.ribs.core.routing.action.RoutingAction
+import io.reactivex.Single
+
+interface Portal : Rib {
+
+    interface OtherSide {
+        fun showRemote(remoteRouter: Router<*, *, *, *, *>, remoteConfiguration: Parcelable)
+    }
+
+    interface Dependency {
+        fun defaultRoutingAction(): (Portal.OtherSide) -> RoutingAction<Nothing>
+    }
+
+    interface Workflow {
+        fun showDefault(): Single<Node<*>>
+        fun showInPortal(ancestryInfo: AncestryInfo): Single<Node<*>>
+    }
+}
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/PortalBuilder.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/PortalBuilder.kt
new file mode 100644
index 000000000..2b64589e1
--- /dev/null
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/PortalBuilder.kt
@@ -0,0 +1,28 @@
+package com.badoo.ribs.core.routing.portal
+
+import android.os.Bundle
+import com.badoo.ribs.core.Builder
+
+class PortalBuilder(
+    override val dependency: Portal.Dependency
+) : Builder<Portal.Dependency>() {
+
+    fun build(savedInstanceState: Bundle?): PortalNode {
+        val router = PortalRouter(
+            savedInstanceState = savedInstanceState
+        )
+
+        router.defaultRoutingAction = dependency.defaultRoutingAction().invoke(router)
+
+        val interactor = PortalInteractor(
+            savedInstanceState = savedInstanceState,
+            router = router
+        )
+
+        return PortalNode(
+            savedInstanceState = savedInstanceState,
+            router = router,
+            interactor = interactor
+        )
+    }
+}
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/PortalInteractor.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/PortalInteractor.kt
new file mode 100644
index 000000000..87b4d0f89
--- /dev/null
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/PortalInteractor.kt
@@ -0,0 +1,16 @@
+package com.badoo.ribs.core.routing.portal
+
+import android.os.Bundle
+import com.badoo.ribs.core.Interactor
+import com.badoo.ribs.core.Router
+import com.badoo.ribs.core.routing.portal.PortalRouter.Configuration
+import com.badoo.ribs.core.routing.portal.PortalRouter.Configuration.Content
+
+internal class PortalInteractor(
+    savedInstanceState: Bundle?,
+    router: Router<Configuration, *, Content, Nothing, Nothing>
+) : Interactor<Configuration, Content, Nothing, Nothing>(
+    savedInstanceState = savedInstanceState,
+    router = router,
+    disposables = null
+)
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/PortalNode.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/PortalNode.kt
new file mode 100644
index 000000000..b47048dcd
--- /dev/null
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/PortalNode.kt
@@ -0,0 +1,29 @@
+package com.badoo.ribs.core.routing.portal
+
+import android.os.Bundle
+import com.badoo.ribs.core.Node
+import com.badoo.ribs.core.routing.portal.PortalRouter.Configuration.Content
+import io.reactivex.Single
+
+class PortalNode internal constructor(
+    savedInstanceState: Bundle?,
+    private val router: PortalRouter,
+    interactor: PortalInteractor
+) : Node<Nothing>(
+    savedInstanceState = savedInstanceState,
+    identifier = object : Portal {},
+    viewFactory = null,
+    router = router,
+    interactor = interactor
+), Portal.Workflow {
+
+    override fun showDefault(): Single<Node<*>> =
+        attachWorkflow {
+            router.push(Content.Default)
+        }
+
+    override fun showInPortal(ancestryInfo: AncestryInfo): Single<Node<*>> =
+        attachWorkflow {
+            router.push(Content.Portal(ancestryInfo.configurationChain))
+        }
+}
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/PortalRouter.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/PortalRouter.kt
new file mode 100644
index 000000000..86939b926
--- /dev/null
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/core/routing/portal/PortalRouter.kt
@@ -0,0 +1,67 @@
+package com.badoo.ribs.core.routing.portal
+
+import android.os.Bundle
+import android.os.Parcelable
+import com.badoo.ribs.core.Router
+import com.badoo.ribs.core.routing.action.RoutingAction
+import com.badoo.ribs.core.routing.configuration.ConfigurationResolver
+import com.badoo.ribs.core.routing.portal.PortalRouter.Configuration
+import com.badoo.ribs.core.routing.portal.PortalRouter.Configuration.Content
+import com.badoo.ribs.core.view.RibView
+import kotlinx.android.parcel.Parcelize
+
+class PortalRouter(
+    savedInstanceState: Bundle?
+): Router<Configuration, Nothing, Content, Nothing, Nothing>(
+    savedInstanceState = savedInstanceState,
+    initialConfiguration = Content.Default,
+    permanentParts = emptyList()
+), Portal.OtherSide {
+
+    internal lateinit var defaultRoutingAction: RoutingAction<Nothing>
+
+    sealed class Configuration : Parcelable {
+        sealed class Content : Configuration() {
+            @Parcelize object Default : Content()
+            @Parcelize data class Portal(val configurationChain: List<Parcelable>) : Content()
+        }
+    }
+
+    override fun showRemote(remoteRouter: Router<*, *, *, *, *>, remoteConfiguration: Parcelable) {
+        push(Content.Portal(remoteRouter.node.ancestryInfo.configurationChain + remoteConfiguration))
+    }
+
+    override fun resolveConfiguration(configuration: Configuration): RoutingAction<Nothing> =
+        when (configuration) {
+            is Content.Default -> defaultRoutingAction
+            is Content.Portal -> configuration.configurationChain.resolve() as RoutingAction<Nothing>
+        }
+
+    // TODO probably needs to change from List<Parcelable> to List<AncestryInfo>,
+    //  so that extra info can be added too. See below for details.
+    private fun List<Parcelable>.resolve(): RoutingAction<out RibView> {
+        // TODO grab first from real root somehow -- currently works only if PortalRouter is in the root rib
+        var targetRouter: ConfigurationResolver<Parcelable, *> =
+            this@PortalRouter as ConfigurationResolver<Parcelable, *>
+        var routingAction: RoutingAction<out RibView> =
+            targetRouter.resolveConfiguration(first())
+
+        drop(1).forEach { element ->
+            // TODO for maximum correctness, original List<> should also contain Bundles,
+            //  as that might change how dependencies are built.
+            val bundles = emptyList<Bundle?>()
+
+            // TODO don't build it again if already available as child.
+            //  This probably means storing Node identifier in addition to (Parcelable) configuration.
+            val nodes = routingAction.buildNodes(bundles)
+
+            // TODO having 0 nodes is an impossible scenario, but having more than 1 can be valid.
+            //  Solution is again to store Node identifiers & Bundles that help picking the correct one.
+            val node = nodes.first()
+            targetRouter = node.node.resolver as ConfigurationResolver<Parcelable, *>
+            routingAction = targetRouter.resolveConfiguration(element)
+        }
+
+        return routingAction
+    }
+}
diff --git a/android/libraries/rib-base/src/main/java/com/badoo/ribs/customisation/CanProvidePortal.kt b/android/libraries/rib-base/src/main/java/com/badoo/ribs/customisation/CanProvidePortal.kt
new file mode 100644
index 000000000..f97e8a158
--- /dev/null
+++ b/android/libraries/rib-base/src/main/java/com/badoo/ribs/customisation/CanProvidePortal.kt
@@ -0,0 +1,8 @@
+package com.badoo.ribs.customisation
+
+import com.badoo.ribs.core.routing.portal.Portal
+
+
+interface CanProvidePortal {
+    fun portal(): Portal.OtherSide
+}
diff --git a/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/RouterTest.kt b/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/RouterTest.kt
index a115dc2f0..1fcc6cb0b 100644
--- a/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/RouterTest.kt
+++ b/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/RouterTest.kt
@@ -1,6 +1,5 @@
 package com.badoo.ribs.core
 
-import android.os.Bundle
 import com.badoo.ribs.core.helper.TestRouter
 import com.badoo.ribs.core.helper.TestView
 import com.badoo.ribs.core.routing.action.RoutingAction
@@ -9,7 +8,6 @@ import com.nhaarman.mockitokotlin2.anyOrNull
 import com.nhaarman.mockitokotlin2.doReturn
 import com.nhaarman.mockitokotlin2.mock
 import com.nhaarman.mockitokotlin2.verify
-import org.junit.Assert
 import org.junit.Assert.assertEquals
 import org.junit.Before
 import org.junit.Test
@@ -39,7 +37,7 @@ class RouterTest {
 
         val nodeDescriptorsC2 =
             listOf(childNodeC2_1, childNodeC2_2).map {
-                Node.Descriptor(it, Node.ViewAttachMode.PARENT)
+                Node.Descriptor(it, Node.AttachMode.PARENT)
             }
 
         routingActionForC2 = mock { on { buildNodes(anyOrNull())} doReturn nodeDescriptorsC2 }
diff --git a/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/helper/TestNode.kt b/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/helper/TestNode.kt
index 3a6ccec74..1c24c5249 100644
--- a/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/helper/TestNode.kt
+++ b/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/helper/TestNode.kt
@@ -3,18 +3,20 @@ package com.badoo.ribs.core.helper
 import android.os.Bundle
 import android.view.ViewGroup
 import com.badoo.ribs.core.Node
+import com.badoo.ribs.core.Router
 import com.badoo.ribs.core.Rib
 import com.nhaarman.mockitokotlin2.mock
 
 open class TestNode(
-    savedInstanceState: Bundle?,
-    identifier: Rib,
-    viewFactory: ((ViewGroup) -> TestView?)? = mock()
+    savedInstanceState: Bundle? = null,
+    identifier: Rib = mock(),
+    viewFactory: ((ViewGroup) -> TestView?)? = mock(),
+    router: Router<*, *, *, *, TestView> = mock()
 ) : Node<TestView>(
     savedInstanceState = savedInstanceState,
     identifier = identifier,
     viewFactory = viewFactory,
-    router = mock(),
+    router = router,
     interactor = mock()
 ) {
     var handleBackPress: Boolean =
diff --git a/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/helper/TestRouter.kt b/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/helper/TestRouter.kt
index 1d4888268..79f4f05d2 100644
--- a/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/helper/TestRouter.kt
+++ b/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/helper/TestRouter.kt
@@ -4,20 +4,21 @@ import android.os.Bundle
 import android.os.Parcelable
 import com.badoo.ribs.core.Router
 import com.badoo.ribs.core.routing.action.RoutingAction
+import com.nhaarman.mockitokotlin2.mock
 import kotlinx.android.parcel.Parcelize
 
 class TestRouter(
-    savedInstanceState: Bundle?,
-    initialConfiguration: Configuration,
-    permanentParts: List<Nothing>,
-    private val routingActionForC1: RoutingAction<TestView>,
-    private val routingActionForC2: RoutingAction<TestView>,
-    private val routingActionForC3: RoutingAction<TestView>,
-    private val routingActionForC4: RoutingAction<TestView>,
-    private val routingActionForC5: RoutingAction<TestView>,
-    private val routingActionForO1: RoutingAction<TestView>,
-    private val routingActionForO2: RoutingAction<TestView>,
-    private val routingActionForO3: RoutingAction<TestView>
+    savedInstanceState: Bundle? = null,
+    initialConfiguration: Configuration = Configuration.C1,
+    permanentParts: List<Nothing> = emptyList(),
+    private val routingActionForC1: RoutingAction<TestView> = mock(),
+    private val routingActionForC2: RoutingAction<TestView> = mock(),
+    private val routingActionForC3: RoutingAction<TestView> = mock(),
+    private val routingActionForC4: RoutingAction<TestView> = mock(),
+    private val routingActionForC5: RoutingAction<TestView> = mock(),
+    private val routingActionForO1: RoutingAction<TestView> = mock(),
+    private val routingActionForO2: RoutingAction<TestView> = mock(),
+    private val routingActionForO3: RoutingAction<TestView> = mock()
 ) : Router<TestRouter.Configuration, Nothing, TestRouter.Configuration, Nothing, TestView>(
     savedInstanceState = savedInstanceState,
     initialConfiguration = initialConfiguration,
diff --git a/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/routing/configuration/ConfigurationContextTest.kt b/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/routing/configuration/ConfigurationContextTest.kt
index 0eb9cbaec..ad55f94e9 100644
--- a/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/routing/configuration/ConfigurationContextTest.kt
+++ b/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/routing/configuration/ConfigurationContextTest.kt
@@ -9,6 +9,7 @@ import com.badoo.ribs.core.routing.configuration.ConfigurationContext.Activation
 import com.badoo.ribs.core.routing.configuration.ConfigurationContext.ActivationState.SLEEPING
 import com.badoo.ribs.core.routing.configuration.ConfigurationContext.Resolved
 import com.badoo.ribs.core.routing.configuration.ConfigurationContext.Unresolved
+import com.badoo.ribs.core.routing.portal.AncestryInfo
 import com.nhaarman.mockitokotlin2.any
 import com.nhaarman.mockitokotlin2.anyOrNull
 import com.nhaarman.mockitokotlin2.doReturn
@@ -27,6 +28,16 @@ class ConfigurationContextTest {
     private val resolver = mock<(Parcelable) -> RoutingAction<*>> {
         on { invoke(any()) } doReturn routingAction
     }
+
+    private val mockAnchor: Node<*> = mock()
+    private val routingActionWithAnchor = mock<RoutingAction<*>> {
+        on { buildNodes(anyOrNull()) } doReturn nodeDescriptors
+        on { anchor() } doReturn mockAnchor
+    }
+    private val resolverWithAnchor = mock<(Parcelable) -> RoutingAction<*>> {
+        on { invoke(any()) } doReturn routingActionWithAnchor
+    }
+
     private val onResolution = { resolved: Resolved<Parcelable> ->
         resolved
     }
@@ -96,6 +107,39 @@ class ConfigurationContextTest {
         assertEquals(nodeDescriptors, resolved.nodes)
     }
 
+    @Test
+    fun `Unresolved resolve() sets AncestryInfo on built Nodes with parent as default anchor `() {
+        val configuration = mock<Parcelable>()
+        val unresolved = Unresolved(mock(), configuration)
+        val targetResolver = resolver
+        val parentNode = mock<Node<*>>()
+        val resolved = unresolved.resolve(targetResolver, parentNode, onResolution)
+        resolved.nodes.forEach {
+            val expected = AncestryInfo.Child(
+                parentNode,
+                configuration
+            )
+
+            verify(it.node).ancestryInfo = expected
+        }
+    }
+
+    @Test
+    fun `Unresolved resolve() sets AncestryInfo on built Nodes with expected anchor `() {
+        val configuration = mock<Parcelable>()
+        val unresolved = Unresolved(mock(), configuration)
+        val targetResolver = resolverWithAnchor
+        val resolved = unresolved.resolve(targetResolver, mock(), onResolution)
+        resolved.nodes.forEach {
+            val expected = AncestryInfo.Child(
+                mockAnchor,
+                configuration
+            )
+
+            verify(it.node).ancestryInfo = expected
+        }
+    }
+
     @Test
     fun `Resolved sleep() keeps INACTIVE`() {
         val resolved = Resolved<Parcelable>(INACTIVE, mock(), mock(), mock(), mock())
diff --git a/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/routing/configuration/ConfigurationFeatureTest.kt b/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/routing/configuration/ConfigurationFeatureTest.kt
index aa2c4568e..5ea87ce5f 100644
--- a/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/routing/configuration/ConfigurationFeatureTest.kt
+++ b/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/routing/configuration/ConfigurationFeatureTest.kt
@@ -5,7 +5,7 @@ import android.os.Parcelable
 import com.badoo.mvicore.element.TimeCapsule
 import com.badoo.ribs.core.Node
 import com.badoo.ribs.core.Node.Descriptor
-import com.badoo.ribs.core.Node.ViewAttachMode
+import com.badoo.ribs.core.Node.AttachMode
 import com.badoo.ribs.core.routing.action.RoutingAction
 import com.badoo.ribs.core.routing.configuration.ConfigurationCommand.MultiConfigurationCommand.Sleep
 import com.badoo.ribs.core.routing.configuration.ConfigurationCommand.MultiConfigurationCommand.WakeUp
@@ -79,7 +79,7 @@ class ConfigurationFeatureTest {
         val routingAction: RoutingAction<*>
     ) {
         companion object {
-            fun create(configuration: Configuration, nbNodes: Int, viewAttachMode: ViewAttachMode): ConfigurationTestHelper {
+            fun create(configuration: Configuration, nbNodes: Int, viewAttachMode: AttachMode): ConfigurationTestHelper {
                 val nodes = MutableList(nbNodes) { i ->
                     Descriptor(
                         mock { on { toString() } doReturn "Node #$i of $configuration" },
@@ -120,25 +120,25 @@ class ConfigurationFeatureTest {
     @Before
     fun setUp() {
         helperPermanent1 =
-            ConfigurationTestHelper.create(Permanent1,2, ViewAttachMode.PARENT)
+            ConfigurationTestHelper.create(Permanent1,2, AttachMode.PARENT)
 
         helperPermanent2 =
-            ConfigurationTestHelper.create(Permanent2,3, ViewAttachMode.PARENT)
+            ConfigurationTestHelper.create(Permanent2,3, AttachMode.PARENT)
 
         helperContentViewParented1 =
-            ConfigurationTestHelper.create(ContentViewParented1,2, ViewAttachMode.PARENT)
+            ConfigurationTestHelper.create(ContentViewParented1,2, AttachMode.PARENT)
 
         helperContentViewParented2 =
-            ConfigurationTestHelper.create(ContentViewParented2,3, ViewAttachMode.PARENT)
+            ConfigurationTestHelper.create(ContentViewParented2,3, AttachMode.PARENT)
 
         helperContentViewParented3 =
-            ConfigurationTestHelper.create(ContentViewParented3,2, ViewAttachMode.PARENT)
+            ConfigurationTestHelper.create(ContentViewParented3,2, AttachMode.PARENT)
 
         helperContentExternal1 =
-            ConfigurationTestHelper.create(ContentExternal1,2, ViewAttachMode.EXTERNAL)
+            ConfigurationTestHelper.create(ContentExternal1,2, AttachMode.EXTERNAL)
 
         helperContentExternal2 =
-            ConfigurationTestHelper.create(ContentExternal2,3, ViewAttachMode.EXTERNAL)
+            ConfigurationTestHelper.create(ContentExternal2,3, AttachMode.EXTERNAL)
 
         val helpers = listOf(
             helperPermanent1,
diff --git a/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/routing/portal/PortalRouterTest.kt b/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/routing/portal/PortalRouterTest.kt
new file mode 100644
index 000000000..331d2b2a5
--- /dev/null
+++ b/android/libraries/rib-base/src/test/java/com/badoo/ribs/core/routing/portal/PortalRouterTest.kt
@@ -0,0 +1,54 @@
+package com.badoo.ribs.core.routing.portal
+
+import android.os.Parcelable
+import com.badoo.ribs.core.helper.TestNode
+import com.badoo.ribs.core.helper.TestRouter
+import com.badoo.ribs.core.Node
+import com.badoo.ribs.core.routing.action.AttachRibRoutingAction
+import com.badoo.ribs.core.routing.action.AttachRibRoutingAction.Companion.attach
+import com.badoo.ribs.core.routing.portal.PortalRouter.Configuration.Content.Portal
+import com.badoo.ribs.core.routing.portal.PortalRouter.Configuration.Content.Default
+import com.nhaarman.mockitokotlin2.mock
+import org.junit.Assert.*
+import org.junit.Before
+import org.junit.Test
+
+class PortalRouterTest {
+
+    lateinit var router: PortalRouter
+    lateinit var node1: Node<*>
+    lateinit var node2: Node<*>
+    lateinit var node3: Node<*>
+
+
+    @Before
+    fun setUp() {
+        node3 = TestNode()
+        node2 = TestNode(router = TestRouter(routingActionForC3 = attach { node3 }))
+        node1 = TestNode(router = TestRouter(routingActionForC2 = attach { node2 }))
+
+
+
+        router = PortalRouter(
+            savedInstanceState = null
+        ).apply {
+            defaultRoutingAction = attach { node1 }
+        }
+    }
+
+    @Test
+    fun `Resolving Portal configuration builds expected remote Node`() {
+        val remoteRoutingAction = router.resolveConfiguration(
+            Portal(
+                listOf(
+                    Default,
+                    TestRouter.Configuration.C2,
+                    TestRouter.Configuration.C3
+                )
+            )
+        )
+
+        val builtNodes = remoteRoutingAction.buildNodes(emptyList()).map { it.node }
+        assertEquals(listOf(node3), builtNodes)
+    }
+}