<<<<<<< HEAD This is a Next.js project bootstrapped with create-next-app.

Getting Started

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.

Learn More

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

Swift Market

Swift Market is an XRPL-based Global Peer-to-Peer Marketplace. It aims to revolutionize cross-border e-commerce with near-zero transaction fees and instant settlement by leveraging the power of the XRP Ledger.

---

📊 Project Status

Status: In Development

This project is currently under active development. Core features are being built and the architecture is being defined.

---

🏗️ Architecture Overview

The application is built with a modern web stack, consisting of a React frontend and a serverless backend using Firebase Functions. It interacts with both Firestore for data storage and the XRP Ledger for payment processing.

+----------------+      +-----------------------+      +--------------------+
|      User      |----->|    React Frontend     |----->|  Firebase Services |
| (Web Browser)  |      |  (Firebase Hosting)   |      | (Auth, Functions)  |
+----------------+      +-----------------------+      +---------+----------+
                                                                 |
                                     +---------------------------+---------------------------+
                                     |                                                       |
                                     v                                                       v
                             +-----------------+                                 +--------------------+
                             | Firestore DB    |                                 |    XRP Ledger      |
                             | (For Orders)    |                                 | (For Escrow/P2P)   |
                             +-----------------+                                 +--------------------+

---

🛠️ Technology Stack

Frontend

Backend

---

📂 Project Structure

This repository is a monorepo containing the frontend and backend projects.

/
├── functions/              # Main Backend: Firebase Functions (TypeScript, XRPL Integration)
│   ├── src/index.ts
│   └── package.json
├── swift-market/           # Frontend: React Application (TypeScript, Tailwind CSS)
│   ├── src/
│   ├── public/
│   └── package.json
└── README.md               # This file

• functions/: Contains the primary backend logic. These TypeScript cloud functions handle business logic, interact with the Firestore database, and manage the XRP Ledger escrow transactions.
• swift-market/: Contains the client-facing React application, built with TypeScript and styled with Tailwind CSS. This directory is configured for deployment with Firebase Hosting.

---

🚀 Getting Started

Prerequisites

• Node.js (v16 or later)
• Firebase CLI

Installation

1. Clone the repository:

   git clone <repository-url>
   cd <repository-name>

2. Install Frontend Dependencies: Navigate to the React app directory and install the necessary packages.

   cd swift-market
   npm install

3. Install Backend Dependencies: Navigate to the Firebase Functions directory and install its dependencies.

   cd ../functions
   npm install

Running the Application

1. Start the Frontend Development Server: From the swift-market directory, run:

   npm start

   This will open the application on http://localhost:3000.

2. Run Backend Functions Locally: To test the Firebase Functions locally, use the Firebase Emulators. Ensure you have them set up by running firebase init emulators. Then, from the root or functions directory, run:

   firebase emulators:start

---

📜 Available Scripts

Frontend (swift-market/)

• npm start: Runs the app in development mode.
• npm run build: Builds the app for production.
• npm test: Runs the test suite.

Backend (functions/)

• npm run build: Transpile TypeScript to JavaScript.
• npm run serve: Run functions locally using Firebase emulators.
• npm run shell: Launch a shell with emulated functions.
• npm run deploy: Deploy functions to your Firebase project.

4981b75b08ff9e6aa11f0889ad464fe3b41295ec