ProcureLinc is a React Native mobile application for an e-procurement platform that lets registered contractors take part in e-auctions and e-tenders from their phone. It covers the full journey: contractor onboarding with eKYC, browsing live auctions/tenders, purchasing/EMD payments, document submission, and secure bidding.

Platform: Android & iOS (React Native 0.79, React 19)
App ID: com.procure
Backend: REST + WebSocket APIs (base URL configured in src/Services/ApiCall/ApiUrls.tsx)

Features

Contractor registration — multi-stage onboarding (Stage 1–3) including partnership details.
eKYC verification — Organization PAN, Aadhaar (OTP), and GST verification flows; KYC web view.
Authentication & security — login, reset password, two-factor auth, device binding, DSC (Digital Signature Certificate) binding, and request/response encryption.
e-Auctions — live auction listings, forward & reverse auctions, item-wise & auction-wise EMD documents, technical document templates, purchase + transaction status.
e-Tenders — live tender listings, tender details, proceed-to-bid, and Envelope A / B / C plus QCBS / LCS submission with file uploads.
Real-time bidding — STOMP over SockJS WebSocket updates.
Dashboard & profile — auction/tender dashboard counts, contractor profile view/edit, purchased tenders & auctions.
Smooth UX — native-stack screen transitions, animated custom bottom tab bar, Lottie animations, and theming (light/dark via useTheme).

Tech Stack

Area	Library
Framework	React Native 0.79, React 19
Navigation	`@react-navigation/native`, `native-stack`, `bottom-tabs`, `drawer`
State	Redux Toolkit, `react-redux`, `redux-persist`
Data fetching	TanStack React Query, Axios
Forms & validation	Formik, Yup
Real-time	`@stomp/stompjs`, `sockjs-client`
Animation / UI	Reanimated, Gesture Handler, Lottie, Lucide icons, SVG, Linear Gradient
Security	`crypto-js`, `jsencrypt`, `react-native-device-info`
Documents	`exceljs`, `xlsx`, `react-native-blob-util`, `react-native-fs`, document picker
Device	Permissions, Geolocation, Haptic Feedback, WebView

Project Structure

src/
├── Axios/          # Axios instance & interceptors
├── Component/      # Shared components
├── components/     # App-level components (e.g. AppStatusBar)
├── Constant/       # Colors, NavigationString, static config
├── Helper/         # Helper utilities
├── Hooks/          # Custom hooks (e.g. useTheme)
├── Images/         # Image assets
├── Navigation/     # MainStack, Bottom tabs, Drawer, NavigationService
├── Permission/     # Runtime permission handling
├── Redux/          # Store, slices, persistence
├── Screens/        # Feature screens (Auction, Tender, Bidding, Login, etc.)
├── Services/       # API calls & endpoint URLs
├── Styles/         # Shared styles
├── Utils/          # Utilities (encryption, formatting, etc.)
├── api/            # API helpers
├── lottie/         # Lottie animation files
├── socket/         # WebSocket (STOMP/SockJS) setup
└── theme/          # Typography & theme tokens

Navigation entry points:

App.tsx → src/Navigation/Routes.jsx → src/Navigation/MainStack.jsx
Bottom tabs (Home / Auction / Tender / Profile): src/Navigation/Bottom.tsx

Getting Started

Note: Complete the React Native environment setup first.

Prerequisites

Node.js >= 18
JDK 17, Android SDK / Android Studio (for Android)
Xcode + CocoaPods (for iOS, macOS only)

1. Install dependencies

npm install

2. Configure the backend URL

Set the active BASE_URL in src/Services/ApiCall/ApiUrls.tsx. The default points to the demo environment:

const BASE_URL = `https://eproc.godemo.in/`;

3. Start Metro

npm start

4. Run the app

Android

npm run android

iOS (first run / after native dependency changes, install pods):

bundle install            # first time only
bundle exec pod install
npm run ios

Available Scripts

Script	Description
`npm start`	Start the Metro dev server
`npm run android`	Build & run on Android
`npm run ios`	Build & run on iOS
`npm run lint`	Run ESLint
`npm test`	Run Jest tests
`npm run create:users`	Run the user-seeding script (`scripts/create-users.js`)

If a transition or native change doesn't appear, restart Metro with a clean cache: npx react-native start --reset-cache.

Repository

This project is hosted on the internal Git server:

http://git.lincpay/EProcurement/ProcureLinc-Mobile-App.git

Troubleshooting

Metro stale cache — npx react-native start --reset-cache.
Android build issues — cd android && ./gradlew clean, then rebuild.
iOS pods out of date — re-run bundle exec pod install.
General help: React Native Troubleshooting.

[ LincPay Solutions Private Limited ]

README.md Unescape Escape

ProcureLinc — Mobile App