15 दिस॰ 2025·8 मिनट

Claude Code के लिए Flutter UI इटरेशन: एक व्यावहारिक कार्यप्रवाह

Q: How do I keep a Flutter UI iteration small enough to review?

Use a small, testable UI spec first. Write 3–6 lines that cover: - What appears (key widgets/components) - What the tap does (one primary interaction) - What loading/error/empty look like - How you can verify it in 30 seconds Then build only that slice (often one screen + 1–2 widgets).

Q: What’s the best way to turn a user story into a buildable UI spec?

Convert the story into four buckets: - Screens: what changes vs stays the same - Components: new widgets and where they live - States: loading, empty, error, success (what each shows) - Events: taps, back, retry, refresh, form edits If you can’t describe the acceptance check quickly, the story is still too fuzzy for a clean UI diff.

Q: What should I ask an AI assistant for first: code or structure?

Start by generating only a widget tree outline (names + hierarchy + what each part shows). No code. Then request a component responsibility breakdown (what each widget owns). Only after that, generate the stateless scaffold with explicit inputs (values + callbacks), and do styling in a separate pass.

Q: Why does the “one big prompt” approach usually create messy diffs?

Treat it as a hard rule: one intent per iteration . - Iteration A: widget tree/layout - Iteration B: state wiring - Iteration C: navigation wiring If a single commit changes layout, state, and routes together, reviewers won’t know what caused a bug, and rollback gets messy.

Q: How do I add state without bloating my widget code?

Keep widgets “dumb”: they should render state , not decide business rules. A practical default: - Create one controller/view-model that owns events and async work - Expose a single state object (loading/empty/error/success) - UI reads state and calls callbacks (retry, submit, toggle) Avoid putting async calls in —it leads to repeated calls on rebuild.

Q: How do I keep navigation flows from getting scattered and inconsistent?

Write a tiny “flow map” for the story: - Entry: where the user comes from - Next: the main forward step - Cancel: where they land if they abandon - Back: what back should preserve or discard - Fallback: what happens if required data is missing Also lock down what travels between screens (IDs, filters, draft data) so you don’t end up hiding context in globals.

Q: What folder structure helps keep UI changes contained?

Default to feature-first folders so changes stay contained. For example: - - - - Then keep each iteration focused on one feature folder and avoid drive-by refactors elsewhere.

Q: How do I make my Flutter UI more modular without over-engineering it?

A simple rule: stabilize interfaces, not internals . - Keep public widget props small and typed - Prefer passing values + callbacks over reading global state - Keep route arguments explicit (often a single args object) - Extract a widget once it stops changing every hour Reviewers care most that inputs/outputs stayed stable even if the layout moved around.

Q: What’s a quick pre-commit checklist for a safe UI iteration?

Do a two-minute pass: - Can you trigger loading, empty, error, success and do they look acceptable? - Does back return where you expect (no weird jumps)? - Did you change only a small set of files with clear ownership? - Are there any temporary flags/placeholders that could break later? If your workflow supports it (for example snapshots/rollback), take a snapshot before a bigger layout refactor so you can revert safely.

Claude Code के लिए Flutter UI इटरेशन: एक व्यावहारिक लूप जो यूज़र स्टोरियों को विजेट ट्री, स्टेट और नेविगेशन में बदलने का तरीका बताता है, ताकि बदलाव मॉड्यूलर और रिव्यू करने में आसान रहें।

समस्या: तेज़ UI इटरेशन जो अराजकता में ना बदल जाए

तेज़ Flutter UI काम अक्सर अच्छी शुरुआत करता है। आप लेआउट को थोड़ा बदलते हैं, एक बटन जोड़ते हैं, एक फील्ड घुमाते हैं — और स्क्रीन जल्दी बेहतर दिखने लगती है। समस्या तब आती है जब कुछ राउंड के बाद तेज़ी परिवर्तनों के ढेर में बदल जाती है जिसे कोई रिव्यू करना नहीं चाहता।

टीम अक्सर वही गलतियाँ करती हैं:

विजेट ट्री बिना किसी योजना के बढ़ता जाता है, इसलिए एक “छोटा” बदलाव कई फाइलों में संपादन मजबूर कर देता है।
स्टेट UI कोड पर जोड़ दिया जाता है, जिससे रिबिल्ड्स अप्रत्याशित और बग ट्रेस करना कठिन हो जाता है।
नेविगेशन लॉजिक इधर-उधर बिखर जाता है (यहाँ push, वहाँ pop), जब तक फ्लो असल यूज़र व्यवहार से मेल नहीं खाते।
नेमिंग डिफ्ट हो जाती है, कम्पोनेंट्स डुप्लिकेट हो जाते हैं, और कोई सुनिश्चित नहीं रहता कि कौन सा विजेट “असली” है।
डिफ़्स बहुत बड़े हो जाते हैं, रिव्यूअर सरसराते हैं, मुद्दे निकल जाते हैं, और बाद में रिग्रेशन दिखते हैं।

एक बड़ा कारण है “एक बड़ा प्रॉम्प्ट” अप्रोच: पूरी फ़ीचर का वर्णन करें, सभी स्क्रीन मांगें, और बड़ा आउटपुट स्वीकार करें। असिस्टेंट मदद करने की कोशिश करता है, पर एक साथ बहुत सारे हिस्सों को छू लेता है। इससे बदलाव गड़बड़, रिव्यू के लिए कठिन और मर्ज करने में जोखिम भरे हो जाते हैं।

एक दोहराने योग्य लूप स्पष्टता लाकर ब्लास्ट रेंज को सीमित करता है। “फ़ीचर बनाओ” की बजाय, इसे बार-बार करें: एक यूज़र स्टोरी चुनें, इसका सबसे छोटा UI स्लाइस जनरेट करें जो उसे साबित करे, केवल उसी स्लाइस के लिए आवश्यक स्टेट जोड़ें, फिर एक पथ के लिए नेविगेशन वायर करें। प्रत्येक पास छोटा रहता है, रिव्यू आसान होता है, और गलतियाँ वापस करना सरल।

लक्ष्य यहाँ एक व्यावहारिक वर्कफ़्लो देना है जो यूज़र स्टोरियों को स्क्रीन, स्टेट हैंडलिंग, और नेविगेशन फ्लोज़ में बदल दे बिना नियंत्रण खोए। अच्छे तरीके से किया जाए तो आप मॉड्यूलर UI टुकड़े, छोटे डिफ़्स, और आवश्यकताओं बदलते समय कम आश्चर्य पाएंगे।

यूज़र स्टोरी को बनायें एक स्पष्ट UI स्पेक जिसे आप बना सकें

यूज़र स्टोरीज़ इंसानों के लिए लिखी जाती हैं, विजेट ट्री के लिए नहीं। कुछ भी जनरेट करने से पहले, स्टोरी को छोटे UI स्पेक में बदलें जो दृश्य व्यवहार बताता हो। “डन” टेस्टेबल होना चाहिए: उपयोगकर्ता क्या देख सकता है, क्या टैप कर सकता है, और क्या कन्फर्म कर सकता है — न कि डिज़ाइन “कितना मॉडर्न लगता है।”

एक सरल तरीका स्कोप को ठोस रखने का है स्टोरी को चार भागों में बाँटना:

स्क्रीन: क्या बदलता है, क्या जैसा है वैसा ही रहता है।
कम्पोनेंट्स: कौन से नए UI टुकड़े दिखाई देंगे, और वे कहाँ होंगे।
स्टेट्स: लोडिंग, सक्सेस, एरर, खाली—और प्रत्येक क्या दिखाता है।
ईवेंट्स: टैप्स, स्वाइप्स, पुल-टू-रिफ्रेश, बैक नेविगेशन, रीट्राई।

अगर स्टोरी अभी भी धुंधली लगती है, इन सवालों का सीधे-सादे भाषा में जवाब दें:

कौन सी स्क्रीन बदलती हैं और कौन सी वैसी ही रहती हैं?
कौन से नए कम्पोनेंट्स दिखते हैं और वे कहाँ होंगे?
कौन से स्टेट्स मौजूद हैं, और हर स्टेट में क्या दिखेगा?
कौन से ईवेंट स्टेट बदलते हैं?
रन करने के 30 सेकंड बाद आप क्या चेक कर के कह सकेंगे कि यह पूरा हुआ?

शुरू में सीमाएँ जोड़ें क्योंकि वे हर लेआउट चुनाव को मार्गदर्शित करती हैं: थीम के बेसिक्स (रंग, स्पेसिंग, टाइपोग्राफी), रिस्पॉन्सिवनेस (पहले फ़ोन पोर्ट्रेट, फिर टैबलेट), और एक्सेसिबिलिटी न्यूनतम जैसे टैप टार्गेट साइज, पठनीय टेक्स्ट स्केलिंग, और आइकन के लिए अर्थपूर्ण लेबल।

अंत में, तय करें क्या स्थिर है और क्या लचीला ताकि आप कोडबेस को बार-बार बदलने से बचा सकें। स्थिर आइटम वे हैं जिनपर दूसरे फीचर निर्भर करते हैं, जैसे रूट नाम, डेटा मॉडल, और मौजूद APIs। लचीले आइटम सुरक्षित होते हैं पर इटरेट करने के लिए—जैसे लेआउट स्ट्रक्चर, माइक्रोकॉपी, और ठीक-ठीक विजेट कॉम्पोज़िशन।

उदाहरण: “एक यूज़र के रूप में, मैं डिटेल स्क्रीन से आइटम को Favorites में सेव कर सकता/सकती हूँ।” एक बनायाबिल UI स्पेक हो सकता है:

डिटेल स्क्रीन पर एक बुकमार्क आइकन दिखता है।
टैप करने पर सेव्ड स्टेट टॉगल होता है।
सेव करते समय एक छोटा प्रोग्रेस इंडिकेटर दिखाएँ।
असफलता पर इनलाइन एरर और Retry एक्शन दिखाएँ।
नेविगेशन जैसा है वैसा ही रहे (कोई नया रूट नहीं)।

इतना ही काफी है बनाने, रिव्यू करने और बिना अनुमानों के इटरेट करने के लिए।

इटरेशन लूप सेट करें ताकि डिफ़्स छोटे रहें

छोटे डिफ़्स का मतलब धीमी काम नहीं है। इसका मतलब हर UI बदलाव को रिव्यू करना आसान, वापस करना आसान और टूटना मुश्किल बनाना है। सबसे सरल नियम: प्रति इटरेशन एक स्क्रीन या एक इंटरैक्शन।

शुरू होने से पहले एक तंग स्लाइस चुनें। “Orders स्क्रीन में खाली स्टेट जोड़ें” एक अच्छा स्लाइस है। “पूरा Orders फ्लो दोबारा बनाओ” नहीं। लक्ष्य ऐसा डिफ़ रखें जिसे टीममेट एक मिनट में समझ सके।

एक स्थिर फ़ोल्डर संरचना भी बदलावों को सीमित रखने में मदद करती है। एक सरल, फीचर-फर्स्ट लेआउट रोकता है कि आप विजेट्स और रूट्स को ऐप में बिखेर दें:

lib/
  features/
    orders/
      screens/
      widgets/
      state/
      routes.dart

विजेट्स को छोटा और कंपोज़्ड रखें। जब किसी विजेट के पास स्पष्ट इनपुट्स और आउटपुट्स हों, तो आप लेआउट बदल सकते हैं बिना स्टेट लॉजिक को छुए, और स्टेट बदल सकते हैं बिना UI को फिर से लिखे। ऐसे विजेट्स पसंद करें जो साधारण मान और कॉलबैक लेते हों, न कि ग्लोबल स्टेट।

एक रिव्यू योग्य लूप:

स्लाइस के लिए 3–6 लाइन का UI स्पेक लिखें (क्या दिखेगा, टैप्स क्या करेंगे, लोडिंग/एरर कैसा दिखेगा)।
केवल ज़रूरी फाइलें जनरेट या एडिट करें (अक्सर एक स्क्रीन और एक-दो विजेट)।
स्क्रीन चलाएँ, फिर एक क्लीनअप पास करें (नेमिंग, स्पेसिंग, अनयूज़्ड प्रॉप्स हटाना)।
स्लाइस के अनुरूप कमिट करें और मैसेज रखें।

एक कड़ा नियम सेट करें: हर बदलाव को रिवर्ट या आइसोलेट करना आसान होना चाहिए। इटरेट करते समय ड्राइव-बाय रिफैक्टर्स से बचें। अगर किसी अनदेखे समस्या पर ध्यान गया है, उसे लिख कर अलग कमिट में फिक्स करें।

अगर आपका टूल स्नैपशॉट्स और रोलबैक सपोर्ट करता है, तो हर स्लाइस को एक स्नैपशॉट बिंदु मानें। कुछ vibe-coding प्लेटफ़ॉर्म जैसे Koder.ai स्नैपशॉट्स और रोलबैक शामिल करते हैं, जो大胆 UI परिवर्तन के दौरान एक्सपेरिमेंटेशन को सुरक्षित बना सकते हैं।

एक और आदत जो शुरूआती इटरेशन को शांत रखती है: साझा विजेट्स को संपादित करने से ज़्यादा नए विजेट जोड़ना पसंद करें। साझा कम्पोनेंट्स वही जगह हैं जहाँ छोटे बदलाव बड़े डिफ़्स में बदल जाते हैं।

चरण-दर-चरण: यूज़र स्टोरी से विजेट ट्री जनरेट करें

तेज़ UI काम तब सुरक्षित रहता है जब आप सोचने को टाइपिंग से अलग रख दें। कोड जनरेट करने से पहले एक स्पष्ट विजेट ट्री प्लान प्राप्त करें।

केवल विजेट ट्री का आउटलाइन मांगें। आप विजेट नाम, हायारकी, और हर भाग क्या दिखाता है यही चाहते हैं। अभी कोई कोड नहीं। यहाँ आप गायब स्टेट्स, खाली स्क्रीन और अजीब लेआउट चुनाव पकड़ सकते हैं जब सब कुछ सस्ता बदलने योग्य हो।
कम्पोनेंट ब्रेकडाउन माँगें और जिम्मेदारियाँ लिखवाएँ। हर विजेट को केंद्रित रखें: एक विजेट हेडर रेंडर करे, दूसरा लिस्ट, तीसरा खाली/एरर UI। अगर बाद में किसी चीज़ को स्टेट चाहिए होगा, उसे नोट करें पर अभी लागू न करें।
स्क्रीन स्कैफ़ोल्ड और stateless विजेट्स जनरेट करें। एक सिंगल स्क्रीन फाइल से शुरू करें जिसमें प्लेसहोल्डर कंटेंट और स्पष्ट TODOs हों। इनपुट्स एक्सप्लिसिट रखें (कन्स्ट्रक्टर पैरामीटर्स) ताकि बाद में असली स्टेट प्लग करना आसान हो।
स्टाइलिंग और लेआउट डिटेल्स के लिए अलग पास करें: स्पेसिंग, टाइपोग्राफी, थीमिंग, और रिस्पॉन्सिव बिहेवियर। स्टाइलिंग को अपने ही अलग डिफ़ में रखें ताकि रिव्यू सरल रहें।

एक काम करने वाला प्रॉम्प्ट पैटर्न

सीमाएँ शुरुआत में रखें ताकि असिस्टेंट ऐसा UI न बना दे जिसे आप शिप न कर सकें:

टार्गेट डिवाइसेस (सिर्फ फोन, टैबलेट भी, ओरिएन्टेशन)
डिज़ाइन सीमाएँ (Material 3, मौजूदा थीम रंग, स्पेसिंग नियम)
नेविगेशन अपेक्षाएँ (बैक बिहेवियर, डीप लिंक अगर हों)
एक्सेप्टेंस क्राइटेरिया (क्या दिखाई दे और टैप किया जा सके)
मौजूदा कोड सीमाएँ (कौन सी फाइलें/विजेट्स रहनी चाहिए, नेमिंग कन्वेंशन)

कॉनक्रेट उदाहरण: यूज़र स्टोरी है “As a user, I can review my saved items and remove one.” विजेट ट्री माँगें जिसमें एक ऐप बार, आइटम रोज़ वाली लिस्ट, और एक खाली स्टेट हो। फिर SavedItemsScreen, SavedItemTile, EmptySavedItems जैसे ब्रेकडाउन माँगें। उसके बाद स्टेटलेस स्कैफ़ोल्ड फेक डेटा के साथ जनरेट करें, और आखिर में स्टाइल जोड़ें (डिवाइडर, पैडिंग, स्पष्ट रिमूव बटन) अलग पास में।

UI कोड को फुलाने बिना स्टेट हैंडलिंग जोड़ें

छोटे डिफ़्स जल्दी भेजें

पहले स्क्रीन स्कैफ़ोल्ड जेनरेट करें, फिर छोटे-छोटे कदमों में लेआउट, स्टेट और नेविगेशन दोहराएँ।

ऐप बनाएं

UI इटरेशन तब टूटता है जब हर विजेट निर्णय लेने लगता है। विजेट ट्री को “डम्ब” रखें: यह स्टेट पढ़े और रेंडर करे, बिजनेस नियम न करे।

पहले स्टेट्स को साधारण शब्दों में नाम दें। ज़्यादातर फीचर्स को सिर्फ “लोडिंग” और “डन” से अधिक चाहिए:

लोडिंग (पहला लोड या रिफ्रेश)
खाली (अभी कोई डाटा नहीं)
एरर (रिक्वेस्ट फेल, परमिशन डिनायड)
सक्सेस (डाटा रेडी)
पार्शियल इनपुट (फॉर्म शुरू हुआ पर वैलिड नहीं)

फिर उन ईवेंट्स को list करें जो स्टेट बदल सकते हैं: टैप्स, फॉर्म सबमिट, पुल-टू-रिफ्रेश, बैक, रीट्राई, और “यूज़र ने फील्ड एडिट किया।” पहले यह करने से बाद में अनुमान लगाने की ज़रूरत नहीं रहती।

विजेट्स से स्टेट अलग रखें

फीचर के लिए एक स्टेट अप्रोच चुनें और उस पर टिके रहें। लक्ष्य “सबसे अच्छा पैटर्न” नहीं है, बल्कि निरंतर डिफ़्स हैं।

छोटी स्क्रीन के लिए एक साधारण कंट्रोलर (जैसे ChangeNotifier या ValueNotifier) अक्सर काफी होता है। लॉजिक एक जगह रखें:

इनपुट्स: UI से आने वाले ईवेंट्स (सबमिट, रिफ्रेश, एडिट)
आउटपुट: एक सिंगल स्टेट ऑब्जेक्ट जिसे UI रेंडर करे
साइड इफेक्ट्स: API कॉल्स और नेविगेशन रिक्वेस्ट

कोड डालने से पहले plain English में स्टेट ट्रांज़िशन लिखें। उदाहरण लॉगिन स्क्रीन:

“जब यूज़र Sign in टैप करे: Loading सेट करें। अगर ईमेल अवैध है: Partial input में रहें और इनलाइन मैसेज दिखाएँ। अगर पासवर्ड गलत है: Error सेट करें और Retry सक्षम करें। अगर सफल: Success सेट करें और Home पर नेविगेट करें।”

फिर वही सेंटेंस मिलती-जुलती मिनिमल Dart कोड में जनरेट करें। रिव्यू सरल रहते हैं क्योंकि आप डिफ़ को नियमों से तुलना कर सकते हैं।

इनवैलिड इनपुट्स के लिए टेस्टेबल नियम जोड़ें

वैलिडेशन को स्पष्ट बनाएं। निर्णय लें कि जब इनपुट्स अवैध हों तो क्या होगा:

क्या आप सबमिट ब्लॉक करेंगे या अनुमति देंगे और एरर दिखाएँगे?
कौन से फील्ड्स किस समय एरर दिखाएँगी?
क्या बैक नेविगेशन आंशिक इनपुट को डिस्कार्ड कर देगा या रखेगा?

जब ये जवाब लिखे होते हैं, आपकी UI साफ़ रहती है और स्टेट कोड छोटा रहता है।

असल उपयोगकर्ता व्यवहार के मुताबिक नेविगेशन फ्लोज़ डिज़ाइन करें

अच्छा नेविगेशन एक छोटे नक्शे के रूप में शुरू करें, न कि रूट्स के ढेर के रूप में। हर यूज़र स्टोरी के लिए चार पल लिखें: यूज़र कहाँ से इन्ट्री करता है, सबसे संभावित अगला कदम क्या है, वे कैसे कैंसिल करते हैं, और “बैक” का मतलब क्या है (पिछली स्क्रीन पर जाएँ या सुरक्षित होम स्टेट पर)।

पहले रूट मैप बनाएं, फिर तय करें क्या स्क्रीन के बीच जाता है

एक सरल रूट मैप उन सवालों का जवाब दे जो अक्सर रीवर्क का कारण बनते हैं:

Entry: कौन सी स्क्रीन पहले खुलती है, और कहाँ से (टैब, नोटिफिकेशन, डीप लिंक)
Next: प्राथमिक एक्शन के बाद मुख्य आगे का पथ
Cancel: अगर यूज़र फ्लो छोड़ दे तो कहाँ पहुंचेगा
Back: क्या बैक की अनुमति है और क्या संरक्षित रखा जाना चाहिए
Fallback: अगर आवश्यक डेटा गायब है तो क्या करें

फिर स्क्रीन के बीच पास होने वाले पैरामीटर तय करें। स्पष्ट रहें: IDs (productId, orderId), फिल्टर्स (डेट रेंज, स्टेटस), और ड्राफ्ट डाटा (आंशिक भरा फॉर्म)। अगर आप इससे चूकोगे, तो आप स्टेट ग्लोबल सिंगलटन में छिपा देंगे या स्क्रीन्स को फिर से बनायेंगे ताकि वे संदर्भ “ढूँढ” सकें।

डीप लिंक और “रिज़ल्ट लौटाएँ” पैटर्न की योजना बनाएं

डीप लिंक का महत्व होता है भले आप उन्हें पहले दिन शिप न करें। तय करें कि जब यूज़र बीच के फ्लो में लैंड करे तो क्या होगा: क्या आप गायब डाटा लोड कर पाएंगे, या सुरक्षित एंट्री स्क्रीन पर रीडायरेक्ट करेंगे?

यह भी तय करें कि कौन सी स्क्रीन रिज़ल्ट लौटाएंगी। उदाहरण: “Select Address” स्क्रीन एक addressId लौटाती है, और चेकआउट स्क्रीन बिना फुल रिफ्रेश के अपडेट हो जाती है। रिटर्न शेप छोटा और टाइप्ड रखें ताकि बदलाव रिव्यू में सरल रहें।

कोड करने से पहले एज केस निकालें: अनसेव्ड बदलाव (कन्फर्म डायलॉग दिखाएँ), ऑथ आवश्यक (लॉगिन के बाद पाज़ और रीज़्यूम), और गायब/डिलीटेड डाटा (एरर दिखाएँ और बाहर निकलने का स्पष्ट रास्ता)।

UI बदलावों को रिव्यू योग्य और मॉड्यूलर बनाएं

जब आप तेज़ी से इटरेट करते हैं, असली जोखिम “गलत UI” नहीं है—यह अनरिव्यूएबल UI है। अगर टीममेट यह नहीं बता सकता कि क्या बदला, क्यों बदला, और क्या स्थिर रहा, तो हर अगला इटरेशन धीमा होगा।

एक नियम जो मदद करता है: इंटरफेस पहले लॉक करें, फिर अंदरूनी हिस्से बदलने दें। सार्वजनिक विजेट प्रॉप्स (इनपुट्स), छोटे UI मॉडल्स, और रूट आर्ग्युमेंट्स को स्थिर करें। एक बार ये नामांकित और टाइप किए गए, आप विजेट ट्री को फिर भी बिना बाकी ऐप तोड़े बदल सकते हैं।

छोटे, स्थिर सीम (seams) पसंद करें

कोड जनरेट करने से पहले एक डिफ़-फ्रेंडली योजना माँगें। आप ऐसी योजना चाहेंगे जो बताए कि कौन सी फाइलें बदलेगी और कौन सी अप्रभावित रहेंगी। इससे रिव्यू फोकस्ड रहते हैं और आकस्मिक रिफैक्टर से व्यवहार बदलने से बचता है।

डिफ़्स को छोटा रखने वाले पैटर्न:

सार्वजनिक विजेट्स को पतला रखें: केवल वही डेटा और कॉलबैक स्वीकार करें जो ज़रूरी हों, और सिंगलटन में पहुँचने से बचें।
बिजनेस नियम जल्दी से विजेट्स से बाहर निकालें: निर्णय कंट्रोलर या व्यू मॉडल में रखें, और UI सिर्फ स्टेट रेंडर करे।
जब कोई UI हिस्सा घंटे-घंटे बदलना बंद कर दे, तो उसे एक पुन:उपयोगी विजेट में निकालें जिसकी स्पष्ट, टाइप्ड API हो।
रूट आर्ग्युमेंट्स स्पष्ट रखें (कभी-कभी एक ऑब्जेक्ट कई वैकल्पिक फील्ड्स से बेहतर होता है)।
PR विवरण में छोटा चेंजलॉग जोड़ें: क्या बदला, क्यों, और क्या टेस्ट करना है।

रिव्यूअबल उदाहरण जिसे रिव्यूअर पसंद करते हैं

मान लीजिए यूज़र स्टोरी है “As a shopper, I can edit my shipping address from checkout.” पहले रूट आर्ग्स लॉक करें: CheckoutArgs(cartId, shippingAddressId) स्थिर रहें। फिर स्क्रीन के अंदर इटरेट करें। जब लेआउट सेट हो जाए, तो उसे AddressForm, AddressSummary, और SaveBar में विभाजित करें।

अगर स्टेट हैंडलिंग बदलती है (उदाहरण के लिए, वैलिडेशन विजेट से CheckoutController में चली जाती है), तो रिव्यू पठनीय रहता है: UI फाइलें ज्यादातर रेंडरिंग बदलती हैं, जबकि कंट्रोलर में लॉजिक चेंज एक जगह दिखेगा।

AI असिस्टेंट के साथ इटरेट करते समय सामान्य गलतियाँ और जाल

इटरेशन को आदत बनाएं

चैट-आधारित vibe-coding वर्कफ़्लो का उपयोग करके वेब, सर्वर और मोबाइल ऐप्स end to end बनाएं।

Try Koder

सबसे तेज़ तरीका धीमा पड़ने का है असिस्टेंट से एक बार में सब कुछ बदलवाना। अगर एक कमिट लेआउट, स्टेट, और नेविगेशन को एक साथ छूता है, तो रिव्यूअर को नहीं पता चलेगा कि किस वजह से बग आया, और रोलबैक उलझ जाएगा।

एक सुरक्षित आदत है प्रति इटरेशन एक इरादा: विजेट ट्री बनाएं, फिर स्टेट वायर करें, फिर नेविगेशन कनेक्ट करें।

कोड को गड़बड़ करने वाली गलतियाँ

एक आम समस्या है जनरेटेड कोड को हर स्क्रीन पर नया पैटर्न इंट्रोड्यूस करने देना। अगर एक पेज Provider उपयोग करता है, अगला setState, और तीसरा कस्टम कंट्रोलर क्लास—ऐसा होने पर ऐप जल्दी असंगत बन जाता है। छोटे पैटर्न चुनें और उन पर रोक लगाएँ।

एक और गलती है async काम को सीधे build() में रखना। डेमो में यह ठीक लग सकता है, पर यह रिबिल्ड्स पर बार-बार कॉल करता है, फ्लिकर और ट्रैक करने में कठिन बग बनाता है। कॉल को initState(), व्यू मॉडल, या समर्पित कंट्रोलर में ले जाएँ, और build() को सिर्फ रेंडरिंग पर रखें।

नेमिंग एक शांत जाल है। Widget1, data2, या temp जैसे नाम भविष्य के रिफैक्टर को दर्दनाक बना देते हैं। स्पष्ट नाम असिस्टेंट को भी बेहतर फॉलो-अप चेंजेस देने में मदद करते हैं क्योंकि इरादा साफ़ होता है।

रोकथाम के गार्डरेइल्स:

प्रति इटरेशन केवल इन में से एक बदलें: लेआउट, स्टेट, या नेविगेशन
फीचर भर में एक ही स्टेट पैटर्न का पुनरुपयोग करें
build() के अंदर नेटवर्क या डेटाबेस कॉल न रखें
प्लेसहोल्डर्स के नाम बदलें उससे पहले कि आप और फ़ंक्शनैलिटी जोड़ें
और भी nesting बढ़ाने के बजाय विजेट्स निकालने को प्राथमिकता दें

नेस्टिंग जाल

एक क्लासिक विज़ुअल-बग फिक्स है और भी Container, Padding, Align, और SizedBox जोड़ना जब तक यह सही न दिखे। कुछ पास के बाद ट्री पढ़ने लायक नहीं रहता।

अगर कोई बटन गलत अलाइन है, पहले रैपर्स हटाकर देखें, एक सिंगल पेरेंट लेआउट विजेट का उपयोग करें, या एक छोटा विजेट निकालें जिसके अपने कंस्ट्रेन्‍ट हों।

उदाहरण: एक चेकआउट स्क्रीन जहां लोडिंग के समय कुल कीमत स्किप करती है। एक असिस्टेंट शायद कीमत रो को “स्थिर” करने के लिए और विजेट्स रैप कर देगा। एक साफ़ समाधान है लोडिंग प्लेसहोल्डर से जगह आरक्षित करना जबकि रो स्ट्रक्चर को अपरिवर्तित रखना।

अगले कमिट से पहले त्वरित चेकलिस्ट

कमिट करने से पहले दो मिनट का पास करें जो यूज़र वैल्यू चेक करे और आपको आश्चर्यजनक रिग्रेशन से बचाए। लक्ष्य पूर्णता नहीं है—यह सुनिश्चित करना है कि यह इटरेशन रिव्यू करने योग्य, टेस्ट करने योग्य और वापस करने योग्य हो।

Commit-ready चेकलिस्ट

यूज़र स्टोरी एक बार पढ़ें, फिर रनिंग ऐप (या कम से कम एक साधारण विजेट टेस्ट) के खिलाफ इन आइटम्स को वेरीफाई करें:

विजेट ट्री स्टोरी से मेल खाता है: एक्सेप्टेंस क्राइटेरिया के मुख्य तत्व दिखाई देते हैं और विज़ुअल रूप से इरादतन लगे। टेक्स्ट, बटन और खाली स्पेस जानबूझकर लगे।
सभी स्टेट्स पहुँच योग्य हैं: लोडिंग, एरर, और खाली स्टेट केवल कोड में स्केच न हों—आप हर एक को ट्रिगर कर सकते हैं (डिबग फ्लैग से) और यह स्वीकार्य दिखे।
नेविगेशन और बैक बिहेवियर समझ में आता है: बैक अपेक्षित स्क्रीन पर लौटता है, डायलॉग सही तरीके से बंद होते हैं, और डीप लिंक (अगर उपयोग हुए) सेंसिबल जगह पर उतरते हैं।
डिफ़्स छोटे और जिम्मेदार हैं: बदलाव एक छोटी फाइल सेट तक सीमित हैं जिनकी स्पष्ट जिम्मेदारी है। कोई ड्राइव-बाय रिफैक्टर नहीं।
रोलबैक साफ़ है: अगर आप इस कमिट को रिवर्ट करें तो दूसरी स्क्रीन अभी भी बिल्ड और रन करें। अस्थायी फ्लैग्स या प्लेसहोल्डर एसेट्स हटाएँ जो बाद में तोड़ सकते हैं।

एक वास्तविकता जाँच: अगर आपने एक नई Order details स्क्रीन जोड़ी है, तो आपको (1) लिस्ट से उसे खोलना चाहिए, (2) लोडिंग स्पिनर दिखना चाहिए, (3) एक एरर सिमुलेट कर पाना चाहिए, (4) खाली ऑर्डर दिखना चाहिए, और (5) बिना अजीब कूद के बैक दबाने पर लिस्ट पर वापस लौटना चाहिए।

अगर आपका वर्कफ़्लो स्नैपशॉट्स और रोलबैक सपोर्ट करता है, तो बड़े UI बदलाव से पहले स्नैपशॉट लें। कुछ प्लेटफ़ॉर्म जैसे Koder.ai यह सपोर्ट करते हैं, और यह आपको मेन ब्रांच को जोखिम में डाले बिना तेज़ी से इटरेट करने में मदद कर सकता है।

एक यथार्थवादी उदाहरण: यूज़र स्टोरी से स्क्रीन तीन इटरेशनों में

जल्द काम करने वाला बिल्ड पाएं

चैट से चलने वाले ऐप तक पहुँचें, बिल्ट-इन डिप्लॉय और होस्टिंग विकल्पों के साथ।

तुरंत डिप्लॉय करें

यूज़र स्टोरी: “As a shopper, I can browse items, open a details page, save an item to favorites, and later view my favorites.” लक्ष्य है शब्दों से स्क्रीन तक पहुँचना तीन छोटे, रिव्यू योग्य कदमों में।

इटरेशन 1: सिर्फ ब्राउज़ लिस्ट स्क्रीन पर ध्यान दें। एक ऐसा विजेट ट्री बनाएं जो रेंडर करने के लिए पूरा हो पर असली डाटा से जुड़ा न हो: Scaffold के साथ AppBar, placeholder रोज़ वाली ListView, और लोडिंग व खाली स्टेट के लिए स्पष्ट UI। स्टेट सरल रखें: लोडिंग (CircularProgressIndicator दिखाएँ), खाली (छोटी संदेश और शायद Try again बटन), और रेडी (लिस्ट दिखाएँ)।

इटरेशन 2: डिटेल्स स्क्रीन और नेविगेशन जोड़ें। स्पष्ट रखें: onTap एक रूट पुश करे और छोटा पैरामीटर ऑब्जेक्ट पास करे (उदा.: item id, title)। डिटेल्स पेज को अभी के लिए रीड-ओनली रखें जिसमें एक टाइटल, विवरण प्लेसहोल्डर, और Favorite एक्शन बटन हो। मकसद स्टोरी से मेल खाना है: list -> details -> back, बिना एक्स्ट्रा फ्लो के।

इटरेशन 3: फेवरेइट्स स्टेट अपडेट और UI फीडबैक जोड़ें। एक सिंगल सोर्स ऑफ़ ट्रूथ जोड़ें (भले ही वह अभी इन-मेमोरी ही हो), और इसे दोनों स्क्रीन में वायर करें। Favorite टैप करने पर आइकन तुरंत अपडेट हो और छोटा कन्फर्मेशन दिखे (जैसे SnackBar)। फिर एक Favorites स्क्रीन जोड़ें जो उसी स्टेट को पढ़े और खाली/लिस्ट UI संभाले।

रिव्यूएबल डिफ़ आमतौर पर ऐसा दिखता है:

browse_list_screen.dart: विजेट ट्री प्लस लोडिंग/खाली/रेडी UI
item_details_screen.dart: UI लेआउट और नेविगेशन पैरामीटर स्वीकार करता है
favorites_store.dart: मिनिमल स्टेट होल्डर और अपडेट मेथड
app_routes.dart: रूट्स और टाइप्ड नेविगेशन हेल्पर्स
favorites_screen.dart: स्टेट पढ़ता है और खाली/लिस्ट UI दिखाता है

अगर कोई एक फाइल “हर चीज़ होने वाली जगह” बन जाए, तो आगे बढ़ने से पहले उसे विभाजित करें। छोटे नामी फाइलें अगला इटरेशन तेज़ और सुरक्षित रखती हैं।

अगले कदम: लूप को हर फीचर पर दोहराने योग्य बनाना

अगर वर्कफ़्लो केवल तब काम करता है जब आप “ज़ोन में” हों, तो यह स्क्रीन बदलते ही या कोई टीममेट टच करते ही टूट जाएगा। लूप को आदत बनाएं—इसे लिख कर रखें और परिवर्तन आकार के बारे में गार्डरेइल्स लगाएँ।

एक पुन:उपयोगी प्रॉम्प्ट टेम्पलेट बनाएं

एक टीम टेम्पलेट उपयोग करें ताकि हर इटरेशन एक ही इनपुट से शुरू हो और एक ही तरह का आउटपुट दे। इसे छोटा पर विशिष्ट रखें:

यूज़र स्टोरी + एक्सेप्टेंस क्राइटेरिया ("डन" का मतलब)
UI सीमाएँ (डिज़ाइन सिस्टम, स्पेसिंग, पुन:उपयोग करने वाले कम्पोनेंट्स)
स्टेट नियम (स्टेट कहाँ रहता है, क्या लोकल vs साझा होगा)
नेविगेशन नियम (रूट्स, डीप लिंक, बैक बिहेवियर)
आउटपुट नियम (कौन सी फाइलें छुएँगी, किन टेस्ट्स को अपडेट करें, डिफ़ में क्या समझाएँ)

यह असिस्टेंट को बीच में नए पैटर्न बनाने की संभावना घटा देता है।

“छोटा” को परिभाषित करें ताकि डिफ़्स भविष्यवाणी योग्य रहें

एक परिभाषा चुनें जो कोड रिव्यू में लागू करना आसान हो। उदाहरण के लिए, हर इटरेशन को सीमित फाइलों तक कॅप करें, और UI रिफैक्टर को बिहेवियर चेंज से अलग रखें।

सरल नियमों का सेट:

हर इटरेशन में 3–5 फाइलों से अधिक परिवर्तन न हों
प्रति इटरेशन एक नया विजेट या एक नेविगेशन स्टेप
बीच में नया स्टेट मैनेजमेंट अप्रोच न लाएँ
अगली इटरेशन से पहले हर चेंज कंपाइल और रन होना चाहिए

बुरे कदम को जल्दी वापस लेने के लिए चेकपॉइंट जोड़ें। कम से कम, टैग कमिट्स या लोकल चेकपॉइंट रखें। अगर आपका वर्कफ़्लो स्नैपशॉट्स और रोलबैक सपोर्ट करता है, तो उनका उपयोग आक्रामक रूप से करें।

यदि आप चाहते हैं कि एक चैट-आधारित वर्कफ़्लो अंत तक Flutter ऐप्स जनरेट और परिष्कृत करे, तो Koder.ai में एक प्लानिंग मोड है जो आपको कोड लागू करने से पहले योजना और अपेक्षित फाइल चेंजेस रिव्यू करने में मदद करता है।

अक्सर पूछे जाने वाले प्रश्न

How do I keep a Flutter UI iteration small enough to review?

Use a small, testable UI spec first. Write 3–6 lines that cover:

What appears (key widgets/components)
What the tap does (one primary interaction)
What loading/error/empty look like
How you can verify it in 30 seconds

Then build only that slice (often one screen + 1–2 widgets).

What’s the best way to turn a user story into a buildable UI spec?

Convert the story into four buckets:

Screens: what changes vs stays the same
Components: new widgets and where they live
States: loading, empty, error, success (what each shows)
Events: taps, back, retry, refresh, form edits

If you can’t describe the acceptance check quickly, the story is still too fuzzy for a clean UI diff.

What should I ask an AI assistant for first: code or structure?

Start by generating only a widget tree outline (names + hierarchy + what each part shows). No code.

Then request a component responsibility breakdown (what each widget owns).

Only after that, generate the stateless scaffold with explicit inputs (values + callbacks), and do styling in a separate pass.

Why does the “one big prompt” approach usually create messy diffs?

Treat it as a hard rule: one intent per iteration.

Iteration A: widget tree/layout
Iteration B: state wiring
Iteration C: navigation wiring

If a single commit changes layout, state, and routes together, reviewers won’t know what caused a bug, and rollback gets messy.

How do I add state without bloating my widget code?

Keep widgets “dumb”: they should render state, not decide business rules.

A practical default:

Create one controller/view-model that owns events and async work
Expose a single state object (loading/empty/error/success)
UI reads state and calls callbacks (retry, submit, toggle)

Avoid putting async calls in build()—it leads to repeated calls on rebuild.

Which UI states should I plan for on most screens?

Define states and transitions in plain English before coding.

Example pattern:

Loading: show spinner / skeleton
Empty: show message + action (like Retry)
Error: show inline error + Retry
Success: render content

Then list events that move between them (refresh, retry, submit, edit). Code becomes easier to compare against the written rules.

How do I keep navigation flows from getting scattered and inconsistent?

Write a tiny “flow map” for the story:

Entry: where the user comes from
Next: the main forward step
Cancel: where they land if they abandon
Back: what back should preserve or discard
Fallback: what happens if required data is missing

Also lock down what travels between screens (IDs, filters, draft data) so you don’t end up hiding context in globals.

What folder structure helps keep UI changes contained?

Default to feature-first folders so changes stay contained. For example:

lib/features/<feature>/screens/
lib/features/<feature>/widgets/
lib/features/<feature>/state/
lib/features/<feature>/routes.dart

Then keep each iteration focused on one feature folder and avoid drive-by refactors elsewhere.

How do I make my Flutter UI more modular without over-engineering it?

A simple rule: stabilize interfaces, not internals.

Keep public widget props small and typed
Prefer passing values + callbacks over reading global state
Keep route arguments explicit (often a single args object)
Extract a widget once it stops changing every hour

Reviewers care most that inputs/outputs stayed stable even if the layout moved around.

What’s a quick pre-commit checklist for a safe UI iteration?

Do a two-minute pass:

Can you trigger loading, empty, error, success and do they look acceptable?
Does back return where you expect (no weird jumps)?
Did you change only a small set of files with clear ownership?
Are there any temporary flags/placeholders that could break later?

If your workflow supports it (for example snapshots/rollback), take a snapshot before a bigger layout refactor so you can revert safely.