Skip to content

ejazahmedsiddiqui/Flashmart

Repository files navigation

Flashmart

A modern mobile grocery shopping application built with Expo and React Native.

Flashmart is a cross-platform mobile application designed to deliver a smooth and responsive shopping experience. The project focuses on scalable architecture, reusable components, clean state management, and maintainable folder structure.


Tech Stack

  • React Native
  • Expo
  • JavaScript
  • Expo Router
  • Context API / Zustand
  • Modular component architecture

Project Structure

Flashmart/
├── app/               # Main screens and routing
├── assets/            # Images and static resources
├── components/        # Reusable UI components
├── context/           # Global state providers
├── hooks/             # Custom React hooks
├── store/             # State logic for zustand
├── theme/             # Colors, fonts, layout constants for light/dark theme
├── utilities/         # Helper functions
├── app.json           # Expo configuration
├── package.json       # Dependencies and scripts
└── README.md

⚡ Getting Started

1. Clone the Repository

git clone https://github.com/ejazahmedsiddiqui/Flashmart.git
cd Flashmart

2. Install Dependencies

npm install

or

yarn install

3. Start the Development Server

npx expo start

This will open Expo DevTools in your browser.

  • Press a → Open Android emulator
  • Press i → Open iOS simulator
  • Scan QR code → Open on physical device using Expo Go

📌 Available Scripts

Command Description
npm start Starts Expo development server
npm run android Runs app on Android emulator
npm run ios Runs app on iOS simulator
npm test Runs tests (if configured)

🏗 Architecture Overview

  • Components → Reusable and isolated UI blocks
  • Screens (app folder) → Page-level views
  • Context / Store → Centralized state management
  • Hooks → Encapsulated reusable logic
  • Theme → Centralized styling system

This structure keeps the project scalable and production-ready.


📦 Features

  • Clean and modular UI components
  • Organized folder structure
  • Global state management
  • Responsive layout
  • Cross-platform support (Android & iOS)

🤝 Contributing

  1. Fork the repository
  2. Create a new feature branch
  3. Commit your changes
  4. Open a Pull Request

📄 License

This project is licensed

Images:

image image image image image image image image image image image image image image image image image image image image image image image image image image image

About

Rebuilding Freshmart

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors