সমস্যা সমাধান

কোনো রুট দেখা যায় না

• অ্যাপ্লিকেশন রাউটারের উপযুক্ত অ্যাডাপ্টার ইনস্টল হয়েছে কিনা দেখুন।
• PageFlow প্রোডাকশন প্রিভিউ নয়, ডেভেলপমেন্ট সার্ভারে চলছে কিনা দেখুন।
• পরীক্ষা করা যায় এমন রাউটারবিহীন সাধারণ Vite সেটআপে ইন্টিগ্রেশন সমর্থন করলে স্পষ্ট রুট দিন।

ডায়নামিক পৃষ্ঠা খোলে না

dynamicParams-এ নিরাপদ নমুনা মান যোগ করুন। রুট প্যাটার্ন যাচাই করে তৈরি URL সরাসরি খুলুন, যাতে অথেনটিকেশন বা লোডার রিডাইরেক্ট বোঝা যায়।

প্রিভিউ ফাঁকা বা লোড হতে থাকে

• অ্যাপ্লিকেশন কনসোল ও নেটওয়ার্ক রিকোয়েস্ট দেখুন।
• বর্তমান ব্রাউজার সেশনে পৃষ্ঠা রেন্ডার হয় কিনা দেখুন।
• প্রয়োজনীয় ফন্ট ও ছবি লোড হতে দিন।
• দীর্ঘ অ্যাসিঙ্ক্রোনাস কাজ শেষ হলে window.__UNPLUGIN_PAGEFLOW_READY__?.() কল করুন।

নেভিগেশন অনুপস্থিত

PageFlow সমর্থিত লিংক ও লিটারাল লক্ষ্য আবিষ্কার করে। গণিত প্রোগ্রাম্যাটিক লক্ষ্য ইন্টারঅ্যাকশনের পর দেখা যেতে পারে। Astro island-এর ভেতর ইচ্ছাকৃতভাবে পরীক্ষা করা হয় না; দরকার হলে একই-অরিজিন অ্যাঙ্কর বা data-pageflow-to ব্যবহার করুন।

থাম্বনেইল পুরোনো

ক্যাপচার সারিকে দৃশ্যমান পৃষ্ঠা হালনাগাদ করতে দিন। ক্যাশ দরকার না হলে ডেভেলপমেন্ট সার্ভার বন্ধ করে .unplugin-pageflow/cache সরান।

অথেনটিকেশন পৃষ্ঠা দেখা যায়

অথেনটিকেশন বর্তমান ব্রাউজার সেশন থেকে আসে। একই সেশনে লোকাল অ্যাপে সাইন ইন করুন অথবা প্রত্যাশিত সাইন-ইন/অ্যাক্সেস-ডিনাইড পৃষ্ঠাকেই সঠিক প্রিভিউ হিসেবে ধরুন।

পরীক্ষা যুক্ত হয় না

স্বয়ংক্রিয় সংযোগের নিয়ম দেখে স্পষ্ট pageTests ম্যাপিং যোগ করুন। টেস্ট ধরনের জন্য testCommands এন্ট্রি থাকলেই পরীক্ষা চলতে পারে।

Next.js sidecar ব্যর্থ

অ্যাপ চলছে কিনা, sidecar-এর হোস্ট ও পোর্ট পাওয়া যাচ্ছে কিনা এবং উভয় সারফেস প্রত্যাশিত একই-অরিজিন সেটআপ ব্যবহার করছে কিনা দেখুন। Next.js নির্দেশিকা দেখুন।