Sharefy

Sharefy is a decentralized application (dApp) designed to facilitate listing sharing and student support through a simulated smart contract and NFT system. It connects companies, sponsors, and students in a transparent ecosystem.

Features

• Distributed Listings: Companies can distribute their product listings across different cities.
• Support Contracts: Sponsors can create support contracts for students.
• NFT Tickets: Students can claim support items as NFT tickets.
• Company Dashboard: Companies can view sales and expense statistics.
• User Dashboard: Users can view their claimed tickets and support statistics.

Project Structure

• Frontend: React (Vite) + TypeScript
• Backend: Python (Flask) - Simulates Smart Contracts & NFTs
• Data: JSON files for persistence (listings.json, contracts.json, tickets.json)

Getting Started

Prerequisites

• Node.js & npm (or pnpm)
• Python 3.8+

Installation

1. Clone the repository:

   git clone https://github.com/your-username/sharefy.git
   cd sharefy

2. Install Frontend Dependencies:

   cd Sharefy
   npm install

Running the Application

You need to run both the Backend (Python) and the Frontend (Node.js) terminals simultaneously.

1. Start the Backend Server

This server handles the API logic, simulating the blockchain contracts and data storage.

# In the Sharefy directory
python3 src/app.py

The server will start on http://127.0.0.1:5001

2. Start the Frontend

This launches the React application.

# In the Sharefy directory (in a new terminal)
npm run dev

The application will be accessible at http://localhost:5173

Scripts

• distribute_listings.py: Generates and distributes sample product listings across cities.
• fix_images.py: Utility to fix image paths in the listings data.

Technologies Used

• Frontend: React, TypeScript, Radix UI, Vite
• Backend: Python, Flask
• Data: JSON (Simulated NoSQL/Ledger)