Blog

Berhenti Merusak Tab Expo Router Kamu

2 Februari 2026 9 menit baca

Cara saya menghentikan Expo Router agar tidak me-mount subtree tab baru yang hanya terlihat seperti layar home yang sama di aplikasi campuran stack dan tab.

Berhenti Merusak Tab Expo Router Kamu
ExpoExpo RouterReact NativeNavigasiArsitektur

Cara Saya Memperbaiki Tab yang Terduplikasi di Expo Router

Expo Router cukup mudah kalau tab adalah seluruh aplikasimu.

Semuanya jadi lebih menarik saat aplikasimu punya tab, tetapi juga punya route layar penuh di luar tab untuk hal seperti layar detail, layar proses, layar hasil, layar pembelian, atau onboarding.

Itulah setup saya.

Dan bug-nya sebenarnya bukan "Expo Router rusak".

Bug-nya adalah saya tanpa sengaja membuat subtree tab yang kedua.

Aplikasinya terlihat seperti kembali ke home, tetapi itu bukan instance tab yang sama.

Itu masalah yang sangat berbeda dari sekadar mendarat di layar yang salah.

Saya mendarat di layar yang terlihat benar, tetapi tree tab di baliknya baru.

Jadi kegagalan yang sebenarnya adalah: tab terduplikasi, UI terlihat sama, instance salah.

Itulah sebabnya feed bisa ter-reset, state khusus tab bisa hilang, dan aplikasi bisa terasa tidak konsisten walaupun pengguna sudah "kembali ke home".

Artikel ini ada karena saya mengalami persis masalah itu dan harus membereskannya.

Aplikasi saya tidak punya graph yang hanya berisi tab

Detail pentingnya begini:

navigator tab saya bukan seluruh aplikasi.

Saya punya root stack, dan tab hanyalah satu cabang di dalamnya.

<Stack>
  <Stack.Screen name="(tabs)" />
  <Stack.Screen name="details/[id]" />
  <Stack.Screen name="processing/[id]" />
  <Stack.Screen name="result/[id]" />
  <Stack.Screen name="purchase" />
</Stack>

Struktur itu memang disengaja.

Saya ingin details, processing, dan result berada di luar tab supaya bisa mengambil alih seluruh layar dan menyembunyikan tab bar.

Bagian itu tidak bermasalah.

Masalahnya mulai muncul saat saya terus bernavigasi kembali ke tab seolah /(tabs) hanyalah route biasa.

Di situlah duplikasi terjadi.

Saya tidak selalu kembali ke cabang tab yang sudah ada.

Kadang saya justru membuat cabang yang baru.

Dengan kata lain, aplikasi sudah punya satu shell tab yang hidup di root stack, dan saya tanpa sengaja me-mount shell tab lain yang kebetulan merender UI home yang sama.

Cara termudah menduplikasi tab kamu

Begitu kamu punya graph campuran, aksi seperti ini jadi berbahaya:

router.replace("/(tabs)/(home)");
router.dismissTo("/");

Kelihatannya tidak berbahaya, tetapi itu tidak sama dengan "kembali ke instance tab yang sudah ada".

Yang saya inginkan adalah ini:

root stack
├─ (tabs)            // existing tabs instance
├─ details/[id]
├─ processing/[id]
└─ result/[id]

back action -> return to the existing (tabs) branch

Yang kadang malah saya lakukan adalah ini:

root stack
├─ (tabs)            // original tabs instance still exists
├─ details/[id]
├─ processing/[id]
├─ result/[id]
└─ (tabs)            // fresh tabs instance mounted again

Kasus kedua itulah bug yang sebenarnya.

Artinya pengguna melihat layar home dan tab bar, tetapi mereka tidak lagi berada di cabang tab yang sudah mereka bangun sebelumnya.

Dalam praktiknya, hasilnya seperti ini:

  • me-mount cabang tab kedua di atas cabang yang asli
  • membangun ulang cabang tab alih-alih kembali ke yang sudah ada
  • kehilangan state tab saat ini
  • kehilangan posisi scroll atau state tab yang sudah dimuat
  • membuat riwayat navigasi terasa tidak konsisten

Bagian yang menyebalkan adalah bug ini mudah terlewat.

Kamu tetap melihat layar home.

Kamu tetap melihat tab bar.

Tapi sekarang kamu berada di dalam instance tab yang baru, bukan instance yang sudah dibangun pengguna sebelumnya.

Itulah sebabnya state tab terasa rusak secara acak.

Tentukan dengan tepat apa arti "home" sebenarnya

Setelah itu, saya berhenti memperlakukan "pergi ke home" sebagai ide yang samar.

Saya membuatnya eksplisit:

export const TAB_HOME_ROUTE = "/(tabs)/(home)";
export const TAB_CREATE_ROUTE = "/(tabs)/(create)";
export const TAB_PROFILE_ROUTE = "/(tabs)/(profile)";

Dan saat saya perlu kembali ke tab, saya menargetkan route tab yang sebenarnya:

router.dismissTo("/(tabs)/(home)");

Bukan:

router.dismissTo("/");
router.replace("/(tabs)/(home)");

Akhirnya saya mengandalkan dismissTo untuk ini, tetapi yang penting bukan API-nya.

Yang penting adalah tujuannya tidak lagi samar.

Itulah perbaikan nyata yang pertama.

Begitu targetnya tepat, navigasi berhenti menjadi "sebisanya" dan mulai sesuai dengan graph yang sebenarnya.

Gejalanya bukan "layar yang salah", melainkan "instance yang salah"

Perbedaan itu penting.

Pengguna sering kali masih melihat tab yang benar.

Masalahnya, itu adalah tree tab yang baru.

Itulah sebabnya kerusakannya muncul secara tidak langsung:

  • posisi scroll hilang
  • state tab yang sebelumnya sudah dimuat hilang
  • aplikasi terasa lupa di mana pengguna tadi berada
  • alur yang diulang membuat stack terasa makin aneh seiring waktu

Begitu saya mulai berpikir dengan pertanyaan "apakah saya kembali ke instance tab yang sudah ada, atau membuat yang baru?", seluruh masalah ini jadi jauh lebih mudah dipahami.

Batasi target kembali yang dinamis dengan ketat

Saya juga punya alur yang membawa param returnTo ke mana-mana.

Bagian itu bisa cepat berantakan.

Kalau kamu membiarkan nilai acak apa pun menentukan ke mana aplikasi harus pergi berikutnya, kamu akan berakhir dengan navigasi yang sulit dipahami sekaligus mudah rusak.

Jadi aturan yang saya pilih sederhana:

  • batasi target kembali seketat mungkin
  • kembali ke route tab yang nyata saat targetnya tidak ada atau tidak valid
  • jangan biarkan "kembali ke tempat asalmu" membuat ulang cabang aplikasi yang berbeda

Bagian ini tidak semenarik bug tab terduplikasi, tetapi mendukung tujuan yang sama:

mengembalikan pengguna ke cabang navigasi yang sudah ada, bukan salinan baru dari sesuatu yang hanya terlihat benar.

Apa yang benar-benar memperbaikinya

Kalau harus saya ringkas menjadi beberapa aturan, inilah aturannya:

  • jangan perlakukan /(tabs) sebagai shortcut home yang umum
  • pakai route tab persis yang kamu inginkan, seperti /(tabs)/(home)
  • berpikirlah dalam konteks "instance tab yang sudah ada", bukan "route home mana saja"
  • loloskan target kembali yang dinamis melalui whitelist kecil
  • utamakan masuk kembali ke cabang tab saat ini, bukan membuat cabang baru

Penutup

Kesalahan utamanya adalah saya kurang memahami graph-nya.

Begitu saya menerima bahwa tab hanyalah satu cabang di dalam root stack yang lebih besar, aturan navigasinya jadi jauh lebih sederhana.

Dan sebagai pujian untuk Expo Router, perbaikannya bukan workaround yang jelek.

Bagian tersulitnya hanyalah jujur tentang seperti apa sebenarnya graph aplikasinya.

Tab bukanlah aplikasinya.

Tab hanyalah satu subtree di dalam aplikasi.

Begitu saya berhenti bernavigasi ke "home" secara asal dan mulai kembali ke cabang tab yang persis sudah ada, masalah tab terduplikasi itu hilang.

Kalau aplikasimu punya graph campuran root stack plus tab, dari situlah saya akan mulai.