আপনার React Native কোডবেস গুছিয়ে রাখা
স্কেলেবল আর রক্ষণাবেক্ষণযোগ্য কোডবেস তৈরির একটি গাইড
একটি React Native অ্যাপ্লিকেশনে রক্ষণাবেক্ষণ আর স্কেলেবিলিটির জন্য কোডবেস গুছিয়ে রাখা অত্যন্ত জরুরি। আপনি ফাইল আর ফোল্ডার কীভাবে সাজান, তা ভবিষ্যতে কোডবেসে কাজ করা কতটা সহজ হবে তার ওপর বড় প্রভাব ফেলতে পারে।
এই আর্টিকেলে একটি React Native অ্যাপ্লিকেশনের জন্য ফিচার-ভিত্তিক ফোল্ডার কাঠামো আর প্রতিটি ফোল্ডারের উদ্দেশ্য নিয়ে আলোচনা করা হবে।
src ফোল্ডার
src ফোল্ডার হলো আপনার অ্যাপ্লিকেশনের সব সোর্স কোডের রুট ডিরেক্টরি। এই ফোল্ডারের ভেতরে আরও কয়েকটি সাবফোল্ডার পাবেন, যেগুলোর প্রত্যেকটির নির্দিষ্ট উদ্দেশ্য আছে।
Types
types ফোল্ডারে আপনি অ্যাপ্লিকেশনের global টাইপগুলো ডিফাইন করবেন। এর মধ্যে আছে module টাইপ, interface definition, আর অ্যাপ্লিকেশন জুড়ে ব্যবহার করতে হয় এমন অন্য যেকোনো কাস্টম টাইপ।
সব টাইপের জন্য একটি কেন্দ্রীয় জায়গা থাকলে অ্যাপ্লিকেশন বড় হওয়ার সাথে সাথে সেগুলো ম্যানেজ আর রক্ষণাবেক্ষণ করা সহজ হয়। তাছাড়া এতে নিশ্চিত হয় যে সব ফিচারে টাইপগুলো ধারাবাহিকভাবে ব্যবহার হচ্ছে, টাইপ-সংক্রান্ত বাগের ঝুঁকি কমে আর বাগ হলে তা ধরাও সহজ হয়।
Lib
lib ফোল্ডারে আপনি অ্যাপ্লিকেশন-নির্দিষ্ট এমন ফাইল রাখতে পারেন যেগুলো পুরো অ্যাপ জুড়ে global ভাবে ব্যবহার হয়। এর মধ্যে থাকতে পারে API কল করার জন্য axios instance, error handling সার্ভিস, constant, react-query-তে query client সেটআপ ইত্যাদি।
এই ফাইলগুলো একটি কেন্দ্রীয় জায়গায় থাকলে সেগুলো রক্ষণাবেক্ষণ করা সহজ হয় আর পুরো অ্যাপ্লিকেশনে সেগুলো সামঞ্জস্যপূর্ণ থাকে।
Components
components ফোল্ডারে আপনি সব reusable কম্পোনেন্ট রাখবেন। এই কম্পোনেন্টগুলো বিচ্ছিন্ন হওয়া উচিত আর কোনো নির্দিষ্ট ফিচার বা ডোমেইনের সাথে বাঁধা থাকা উচিত নয়। এই ধরনের কম্পোনেন্টের উদাহরণ হলো header, button আর list item।
এই কম্পোনেন্টগুলো ফিচার-নির্দিষ্ট কম্পোনেন্ট থেকে আলাদা রাখলে অ্যাপ্লিকেশন জুড়ে সেগুলো ম্যানেজ ও পুনরায় ব্যবহার করা সহজ হয়, আর কোডে ডুপ্লিকেশন কমে।
Hooks
hooks ফোল্ডারে আপনি অ্যাপ্লিকেশন জুড়ে ব্যবহৃত কাস্টম hook রাখবেন। hook হলো React-এর একটি বিশেষ ধরনের ফাংশন, যা দিয়ে কম্পোনেন্টগুলোর মধ্যে stateful লজিক পুনরায় ব্যবহার করা যায়।
আপনার reusable বা একাধিক জায়গায় ব্যবহৃত সব কাস্টম hook একটি কেন্দ্রীয় জায়গায় থাকলে সেগুলো ম্যানেজ আর রক্ষণাবেক্ষণ করা সহজ হয়, কোড ডুপ্লিকেশনের ঝুঁকি কমে, আর অ্যাপ্লিকেশনের বিভিন্ন অংশে hook শেয়ার করাও সহজ হয়।
Localization
localization ফোল্ডারে আপনি অ্যাপ্লিকেশনের internationalization সংক্রান্ত সব ফাইল রাখবেন। এর মধ্যে আছে ভাষার ফাইল, string constant, আর অ্যাপ্লিকেশনে একাধিক ভাষা সাপোর্ট করতে দরকারি অন্য যেকোনো রিসোর্স।
এই ফাইলগুলো একটি কেন্দ্রীয় জায়গায় থাকলে সেগুলো ম্যানেজ আর রক্ষণাবেক্ষণ করা সহজ হয়, কোড ডুপ্লিকেশনের ঝুঁকি কমে, আর অ্যাপ্লিকেশনে একাধিক ভাষা সাপোর্ট করাও সহজ হয়।
Navigation
navigation ফোল্ডারে আপনি অ্যাপ্লিকেশনের নেভিগেশন সংক্রান্ত সব কোড রাখবেন। এর মধ্যে আছে stack, টাইপ, route, আর নেভিগেশন সাপোর্ট করতে দরকারি অন্য যেকোনো কম্পোনেন্ট বা ফাংশন।
সব নেভিগেশন কোড একটি কেন্দ্রীয় জায়গায় থাকলে তা ম্যানেজ আর রক্ষণাবেক্ষণ করা সহজ হয়, কোড ডুপ্লিকেশনের ঝুঁকি কমে, আর অ্যাপ্লিকেশনের বিভিন্ন অংশে নেভিগেশন ফাংশনালিটি শেয়ার করাও সহজ হয়।
Services
services ফোল্ডারে আপনি অ্যাপ্লিকেশনের ভিত্তিগত অবকাঠামো সংক্রান্ত সব কোড রাখবেন। এর মধ্যে আছে push notification, error monitoring আর অ্যাপ্লিকেশনের ভিত্তিগত ফাংশনালিটি দিতে ব্যবহৃত অন্য যেকোনো সার্ভিসের কোড।
Theme
theme ফোল্ডারে আপনার অ্যাপের স্টাইলিং রাখা উচিত, যেমন dark/light থিম। স্টাইলিং আর থিমের ফাইলগুলো এক জায়গায় রাখলে প্রয়োজন অনুযায়ী অ্যাপের চেহারা আর অনুভূতি ম্যানেজ ও আপডেট করা সহজ হয়।
Utils
utility ফাংশন আপনার React Native অ্যাপ্লিকেশনের একটি গুরুত্বপূর্ণ অংশ হতে পারে, কারণ এগুলো দিয়ে এমন কোড পুনরায় ব্যবহার করা যায় যা অ্যাপ্লিকেশনের একাধিক অংশে লাগে। অ্যাপ্লিকেশন জুড়ে ব্যবহৃত utility ফাংশন রাখার জন্য utils ফোল্ডার একটি চমৎকার জায়গা। এই ফাংশনগুলো এক জায়গায় কেন্দ্রীভূত করলে কোডের অন্য অংশ থেকে সেগুলো খুঁজে পাওয়া আর ব্যবহার করা সহজ হয়। যেমন: react-native-এর layout সংক্রান্ত utility ফাংশন।
Features
জটিল অ্যাপ্লিকেশন তৈরির ক্ষেত্রে একটি স্পষ্ট আর সংক্ষিপ্ত ফোল্ডার কাঠামো থাকা জরুরি, যা সব কোডকে এক জায়গায় আবদ্ধ রাখে। features ফোল্ডার এটা অর্জনে সাহায্য করে, কারণ এটি অ্যাপ্লিকেশনের বিভিন্ন ফিচারকে আলাদা আলাদা শ্রেণিতে ভাগ করে। এতে ডেভেলপাররা অ্যাপ্লিকেশনের অন্য অংশে প্রভাব না ফেলে দ্রুত একটি নির্দিষ্ট ফিচার খুঁজে তাতে পরিবর্তন করতে পারেন।
তার ওপর অ্যাপ্লিকেশন বড় হলে আর নতুন ফিচার যোগ হলেও ফোল্ডার কাঠামো গোছানো থাকে, ফলে নতুন ডেভেলপারদের পক্ষে কাজে ঢুকে অ্যাপ্লিকেশন কীভাবে কাজ করে তা বোঝা সহজ হয়। দায়িত্বের স্পষ্ট বিভাজন বাগের ঝুঁকি কমাতে আর অ্যাপ্লিকেশনের সামগ্রিক পারফরম্যান্স উন্নত করতেও সাহায্য করে।
একটি auth ফোল্ডার দেখতে এমন হতে পারে:
src/
├── ...
└── features/
├── auth/
| ├── api/
| ├── helpers/
| ├── hooks/
| ├── screens/
| ├── services/
| └── store/
└── ... (other features)
features ফোল্ডারের গুরুত্ব হলো এটি কোডবেসকে ছোট, সহজে সামলানো যায় এমন অংশে ভাগ করতে সাহায্য করে। প্রতিটি ফিচারের নিজস্ব সাবফোল্ডার থাকে, যেমন api, helpers (বা utils), hooks, screens, services আর store, যেগুলো সেই ফিচারের জন্য নির্দিষ্ট। এতে প্রতিটি ফিচার কীভাবে কাজ করে আর সেগুলো একে অপরের সাথে কীভাবে যোগাযোগ করে তা বোঝা সহজ হয়।
api ফোল্ডারে authentication-এর জন্য নির্দিষ্ট সব API-সংক্রান্ত কোড থাকে। এতে API কলগুলো ম্যানেজ করা আর গুছিয়ে রাখা সহজ হয়।
helpers ফোল্ডারে authentication ফিচারের জন্য নির্দিষ্ট helper মেথড বা utility ফাংশন থাকে। এগুলো শুধু authentication ফিচারের ভেতরেই ব্যবহার করা যায় এবং অ্যাপ্লিকেশনের অন্য অংশের সাথে শেয়ার করার দরকার নেই।
hooks ফোল্ডারে বিশেষভাবে authentication সংক্রান্ত hook থাকে। React যেহেতু hook-এর ওপর অনেকটাই নির্ভরশীল, তাই এতে hook-গুলো ম্যানেজ করা আর গুছিয়ে রাখা সহজ হয়।
screens ফোল্ডারে authentication ফিচারের সব স্ক্রিন থাকে। এর মধ্যে আছে login স্ক্রিন, sign-up স্ক্রিন, পাসওয়ার্ড ভুলে যাওয়ার স্ক্রিন ইত্যাদি।
services ফোল্ডারে authentication ফিচারের জন্য নির্দিষ্ট সার্ভিস থাকে। যেমন আপনার একটি authentication সার্ভিস থাকতে পারে যেটি ব্যবহারকারীর login আর sign-up সামলায়।
সবশেষে store ফোল্ডারে authentication ফিচারের জন্য নির্দিষ্ট state management কোড থাকে। এটি একটি Redux store, একটি Zustand store, বা আপনার পছন্দের অন্য যেকোনো state management লাইব্রেরি হতে পারে।
অ্যাপ্লিকেশনকে ছোট, গোছানো অংশে ভাগ করলে কোড ম্যানেজ করা আর প্রয়োজন অনুযায়ী তাতে পরিবর্তন করা অনেক সহজ হয়ে যায়। এটি কোডকে পরিষ্কার আর পাঠযোগ্য রাখতেও সাহায্য করে, ফলে অন্য ডেভেলপারদের পক্ষে কোড বোঝা আর তাতে কাজ করা সহজ হয়।
auth ফিচার ফোল্ডারের নমুনা কাঠামো
src/
└── features/
└── auth/
├── api/
| ├── login.ts
| ├── signup.ts
| └── refresh-token.ts
├── helpers/
| ├── validateToken.ts
| └── dataTransformer.ts
├── screens/
| ├── Login.tsx
| └── Signup.tsx
├── services/
| └── validation.ts
└── store/
└── auth.ts
auth ফোল্ডার হলো আপনার অ্যাপ্লিকেশনের authentication ফিচারের জন্য নির্ধারিত সাবফোল্ডার। login আর signup-এর API থেকে শুরু করে ব্যবহারকারীর ব্যবহারের UI স্ক্রিন পর্যন্ত, authentication আর authorization সংক্রান্ত সবকিছু এই ফোল্ডারের ফাইলগুলো সামলায়।
api ফোল্ডারে authentication ফিচারের API থাকে, যেমন login.ts আর signup.ts ফাইল, যেগুলো ব্যবহারকারীর login আর signup অনুরোধের request ও response সামলায়। refresh-token.ts ফাইলটি token রিফ্রেশ সামলায়।
helpers ফোল্ডারে authentication প্রক্রিয়ায় ব্যবহৃত helper ফাংশন থাকে। যেমন validateToken.ts ফাইল token যাচাই করতে ব্যবহার হয়, আর dataTransformer.ts ফাইল authentication API-তে যাওয়া ও সেখান থেকে আসা ডেটা রূপান্তর করে।
screens ফোল্ডারে সেই UI কম্পোনেন্টগুলো থাকে যেগুলো ব্যবহারকারী ব্যবহার করেন। যেমন Login.tsx আর Signup.tsx ফাইলে যথাক্রমে ব্যবহারকারীর login আর sign up করার UI কম্পোনেন্ট থাকে।
hooks ফোল্ডারে authentication সংক্রান্ত কাস্টম hook থাকে। যেমন useLoginAction.ts আর useSignupForm.ts ফাইলে এমন hook থাকে যেগুলো যথাক্রমে login আর signup ফর্মের state ও action ম্যানেজ করতে সাহায্য করে।
services ফোল্ডারে authentication সংক্রান্ত সার্ভিস থাকে, যেমন validation.ts ফাইল, যাতে ব্যবহারকারীর ইনপুট যাচাইয়ের ফাংশন থাকে।
store ফোল্ডারে authentication সংক্রান্ত state management থাকে। auth.ts ফাইলে Zustand, Redux বা অন্য কোনো state management লাইব্রেরি ব্যবহার করে authentication সংক্রান্ত state আর action থাকে।
সতর্কতা
মনে রাখা গুরুত্বপূর্ণ যে ফোল্ডার আর ফাইলের নামকরণের রীতি প্রজেক্ট থেকে প্রজেক্টে আর ডেভেলপার থেকে ডেভেলপারে আলাদা হতে পারে। প্রতিটি ফোল্ডারের হুবহু নামের চেয়ে ফোল্ডারগুলোর কাঠামো আর বিন্যাসই গুরুত্বপূর্ণ। যেমন অ্যাপের রুটে থাকা utils ফোল্ডারের নাম helpers বা utilities-ও হতে পারে, অথবা screens-এর বদলে এর নাম pages বা নির্দিষ্ট প্রজেক্টের জন্য অর্থবহ অন্য কিছুও হতে পারে। লক্ষ্য হলো একটি স্পষ্ট আর ধারাবাহিক কাঠামো রাখা, যা ডেভেলপারদের কোডের বিন্যাস বুঝতে সাহায্য করে এবং অ্যাপ্লিকেশন রক্ষণাবেক্ষণ ও স্কেল করা সহজ করে।
টাইপ-ভিত্তিক বনাম ফিচার-ভিত্তিক ফোল্ডার কাঠামো
প্রজেক্টের কোডবেস গোছানোর আরেকটি বহুল ব্যবহৃত পদ্ধতি হলো টাইপ-ভিত্তিক ফোল্ডার কাঠামো, যার নিজস্ব সুবিধা আর অসুবিধা আছে। পরের অংশে আমরা এই দুটি ফোল্ডার কাঠামো দৃশ্যমানভাবে তুলনা করব।
তুলনা
Feature-based folder structure:
src/
└── features/
├── auth/
| ├── api/
| │ ├── register.tsx
| │ ├── login.tsx
| │ ├── types.tsx
| │ └── helpers.tsx
| ├── helpers/
| ├── hooks/
| └── screens/
| │ ├── LoginScreen.tsx
| │ ├── SignupScreen.tsx
| │ ├── WelcomeScreen.tsx
| │ └── HomeScreen.tsx
| ├── services/
| └── store/
├── todo/
| └── screens/
| │ └── TodoListScreen.tsx
| ├── services/
| └── store/
└── ... (other features)
Type-based folder structure:
src/
├── screens/
| ├── LoginScreen.tsx
| ├── SignupScreen.tsx
| ├── TodoListScreen.tsx
| ├── WelcomeScreen.tsx
| └── HomeScreen.tsx
├── api/
| └── auth/
| ├── register.ts
| ├── login.ts
| ├── types.ts
| └── helpers.ts
ওপরে যেমন দেখা যাচ্ছে, টাইপ-ভিত্তিক ফোল্ডার কাঠামোতে স্ক্রিনগুলো API কল আর helper থেকে আলাদা থাকে, যা কোডবেস বোঝা কঠিন করে তুলতে পারে। লক্ষ করুন, টাইপ-ভিত্তিক কাঠামোতে আমরা LoginScreen.tsx আর TodoListScreen.tsx-এর মতো সম্পর্কহীন স্ক্রিনকে একই ফোল্ডারে রেখে দিতে পারি। তাছাড়া সম্পর্কিত কোড এক জায়গায় একসাথে না থাকায় কোড রক্ষণাবেক্ষণ করাও কঠিন হয়ে যেতে পারে। অন্যদিকে ফিচার-ভিত্তিক কাঠামোতে authentication সংক্রান্ত সব কোড, যেমন স্ক্রিন, API কল, helper আর সার্ভিস, একটি auth ফোল্ডারে একসাথে থাকে। এতে কোডবেস বোঝা সহজ হয়, কারণ সব সম্পর্কিত কোড এক জায়গায় থাকে। এই পদ্ধতি কোডকে আরও ভালোভাবে আবদ্ধ রাখে এবং প্রজেক্টকে ভবিষ্যতের পরিবর্তনের জন্য স্কেলেবল আর নমনীয় করে।
ফিচার-ভিত্তিক ফোল্ডার কাঠামোর সর্বশেষ চিত্র
ডামি ফাইলসহ ফিচার-ভিত্তিক ফোল্ডার কাঠামো শেষ পর্যন্ত দেখতে এমন হবে:
Feature-based folder structure:
src/
├── components/
│ ├── Button.tsx
│ └── Header.tsx
├── hooks/
│ └── useHeader.ts
├── localization/
│ ├── languages.ts
│ └── locales.ts
├── lib/
│ ├── axios-instance.ts
│ └── constants.ts
├── navigation/
│ ├── root-navigator.tsx
│ └── auth-stack.tsx
├── services/
│ ├── notification.ts
│ └── logging.ts
├── theme/
│ └── index.ts
├── types/
│ ├── env.d.ts
│ └── react-augment.d.ts
├── utils/
│ └── layout.ts
└── features/
├── auth/
│ ├── api/
│ │ ├── login.ts
│ │ ├── signup.ts
│ │ └── refresh-token.ts
│ ├── helpers/
│ │ ├── validateToken.ts
│ │ └── dataTransformer.ts
│ ├── hooks/
│ │ ├── useLoginAction.ts
│ │ └── useSignupForm.ts
│ ├── screens/
│ │ ├── Login.tsx
│ │ └── Signup.tsx
│ ├── services/
│ │ └── validation.ts
│ └── store/
│ └── auth.ts (zustand, redux, jotai etc.)
└── ... (other features)
ওপরের বিভিন্ন ফোল্ডারে যোগ করা ফাইলগুলো (যেমন components ফোল্ডারে button.tsx, header.tsx, hooks ফোল্ডারে useHeader.ts ইত্যাদি) উদাহরণ হিসেবে দেওয়া, এগুলোকে ১০০% নির্ভুল ধরে নেওয়া উচিত নয়। এই ফাইলগুলো রাখার উদ্দেশ্য হলো ফোল্ডার কাঠামোর একটি দৃশ্যমান রূপ দেওয়া এবং কোডবেসের বিন্যাস আরও ভালোভাবে বুঝতে সাহায্য করা। আসল ইমপ্লিমেন্টেশন প্রজেক্টের নির্দিষ্ট প্রয়োজন অনুযায়ী আলাদা হতে পারে। এই আর্টিকেলের মনোযোগ আলাদা আলাদা ফাইলের খুঁটিনাটিতে নয়, বরং ফিচার-ভিত্তিক ফোল্ডার কাঠামো আর এটি কীভাবে একটি স্কেলেবল ও গোছানো কোডবেস তৈরিতে সাহায্য করে তার ওপর।
উপসংহার
আমার মতে React/React Native প্রজেক্ট গোছানোর জন্য ফিচার-ভিত্তিক ফোল্ডার কাঠামো একটি কাজের পদ্ধতি। কোডকে আলাদা আলাদা ফিচারে ভাগ করলে আমার কাছে অ্যাপ্লিকেশন রক্ষণাবেক্ষণ, বোঝা আর ডেভেলপ করা সহজ মনে হয়। এই কাঠামো কোডকে আরও ভালোভাবে আবদ্ধ রাখে, ফলে প্রজেক্ট ভবিষ্যতের পরিবর্তনের জন্য স্কেলেবল আর নমনীয় হয়। অবশ্যই এটি সবার জন্য একই মাপের সমাধান নয়, আর প্রজেক্টের আকার ও জটিলতা অনুযায়ী হুবহু কাঠামো আলাদা হতে পারে। তবে মূল ধারণাটা হলো বিভিন্ন ফিচার আর তাদের নিজ নিজ কম্পোনেন্ট, সার্ভিস ও ডেটার মধ্যে স্পষ্ট বিভাজন রাখা। আমার অভিজ্ঞতায় এই কাঠামো আমাকে এমন গোছানো প্রজেক্ট তৈরি আর রক্ষণাবেক্ষণ করতে সাহায্য করেছে, যেগুলো সময়ের সাথে বৃদ্ধি আর পরিবর্তন সামলাতে সক্ষম। আমি এই পদ্ধতিটি তাদের সাথে শেয়ার করতে চেয়েছি যাদের কাছেও এটি কাজের মনে হতে পারে।
প্রকাশিত হয়েছে
এই আর্টিকেলটি এখানেও প্রকাশিত হয়েছে: