Syncora — Discover Local Excellence

A modern platform designed to help users discover and explore nearby businesses across Retail, Restaurants, and Food through a clean and structured digital experience.

Why This Project Exists

Local businesses often struggle to gain digital visibility compared to large online marketplaces. Syncora explores how a lightweight digital platform can help consumers easily discover nearby brands while giving small businesses an accessible digital presence.

Project Overview

Syncora is a local business discovery platform designed to bridge the digital gap between consumers and nearby businesses. The platform provides a clean and organized digital environment where users can seamlessly explore local stores and discover new brands across three distinct verticals: Retail, Restaurants, and Food.

By allowing businesses to register their stores and automatically assigning them to respective vertical categories, Syncora demonstrates how a well-structured digital platform can connect consumers with local commerce effectively.

Key Highlights

• Built with a full-stack architecture using React, Node.js, and MongoDB.
• Designed to support multiple local commerce verticals.
• Includes seller registration and store discovery flows.
• Demonstrates scalable marketplace-style UI architecture.

Core Features

• Multi-Vertical Store System: Dedicated digital discovery sections specifically for Retail, Restaurants, and Food storefronts.
• Seller Store Registration: A portal allowing local business owners to register their stores and automatically appear in their designated vertical.
• Dynamic Store Discovery Pages: Interactive discovery pages that filter and display stores exclusively by their registered categories.
• Featured Brand Sections: Highlighted sections showcasing prominent local brands on the platform.
• Demo Store System: Pre-populated foundational demo stores showcasing the platform's UI layout organically.
• Fallback Placeholder System: A built-in architecture displaying a "Coming Soon" logo placeholder for newly registered stores without custom images.
• Contact Form with Email Integration: Direct communication portal from consumers to platform administrators, powered by Nodemailer for sending contact form messages.
• Clean and Responsive UI: A modern, device-friendly user interface built prioritizing readability and aesthetics for consumers.

Technology Stack

Layer	Technologies
Frontend	React, Vite, TailwindCSS
Backend	Node.js, Express.js
Database	MongoDB
Email Service	Nodemailer

Project Architecture

The platform follows a decoupled client-server architecture:

User / Browser
      │
      ▼
React Frontend (Vite)
      │
      ▼
Node.js / Express API
      │
      ▼
MongoDB Database

• Frontend: The client-side React application powered by Vite handles all UI rendering, routing, and user interaction. It communicates with the backend via RESTful API calls.
• Backend: The Node.js/Express server acts as the central hub, processing API requests, securely managing data interactions with MongoDB, and dispatching Nodemailer emails.

Project Folder Structure

Syncora/
│
├── frontend/
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── stores/
│   │   ├── utils/
│   │   └── App.jsx
│   └── package.json
│
├── backend/
│   ├── models/
│   ├── scripts/
│   ├── server.js
│   └── package.json
│
└── README.md

Screenshots

Landing Page	Retail Page	Restaurants Page

Food Page	Consumer Vertical

Seller Portal	Seller Registration	Contact Page

Setup Instructions

Follow these steps to set up and run Syncora locally:

1. Clone the Repository

git clone https://github.com/Krishnaaa10/Syncora.git
cd Syncora

2. Install Dependencies

Install the required node packages for both the backend and frontend.

Terminal 1 (Backend):

cd backend
npm install

Terminal 2 (Frontend):

cd frontend
npm install

3. Configure Environment Variables

Create a .env file inside the backend/ directory and configure the following variables:

MONGO_URI=your_mongodb_connection_string
PORT=3001
GMAIL_USER=your_email@gmail.com
GMAIL_APP_PASSWORD=your_16_character_app_password

4. Run the Backend Server

cd backend
npm run dev

5. Run the Frontend Application

cd frontend
npm run dev

Future Improvements

As the platform evolves, the following features are planned to expand its capabilities:

• Seller Dashboard: Providing sellers with a dedicated interface to manage their store details.
• Product Listing per Store: Allowing sellers to list individual items, menus, or catalogs under their storefronts.
• Store Verification System: A backend approval system to verify the authenticity of registered local businesses.
• Better Search Filters: Implementing advanced searches to allow filtering by tags or specific categories.
• Location-Based Discovery: Utilizing geospatial data integration to show users the physical distance to discovered stores.

Collaboration & Contact

Syncora is continuously growing and seeking improvements! Whether you have suggestions for new features, want to report an issue, or are interested in collaborating on the codebase, your input is highly valued.

Feel free to reach out, suggest improvements, or contribute.

📧 Contact: krishnaspattel@gmail.com

---

Credits

Created and maintained by:

Shrikrishna Patel