Ascend Marketplace

Ascend Marketplace is a modern e-commerce application built with React, Vite, and Tailwind CSS. It showcases a product listing and shopping experience in a clean, performant web app. Any one can clone the repositiory, invite users, and begin buying selling and trading in their community.

Tech Stack

• React (Frontend UI)

• Vite (Development/build tooling)

• Tailwind CSS (Styling)

• React Router (Routing)

• Heroicons (Icons)

Setup Instructions

1. Clone the repository git clone https://github.com/Resilient-Labs/AscendMarketplace.git

2. Install dependencies cd AscendMarketplace npm install

3. Start the development server npm run dev The app will usually run at http://localhost:5173.

Project Structure

  src/
  ├── components/   # Reusable UI components (Navbar, ProductCard, etc.)
  ├── pages/        # Route pages (Home, Products, Profile)
  ├── data/         # Static dummy data for products and users
  ├── App.jsx       # Main application layout and routing
  ├── main.jsx      # React root rendering
  └── index.css     # Tailwind CSS imports and custom styles

Features

• Responsive design with Tailwind CSS

• Product catalog page (with placeholder products)

• User authentication page (login/signup UI scaffolded)

• Clean, modular React components

• Client-side routing with React Router

Future Improvements

[ ] Connect to a real backend (e.g., Firebase, Express API)

[ ] User authentication (login/signup workflows)

[ ] Product filtering and search

[ ] Shopping cart functionality

[ ] Payment integration (Stripe, PayPal)

Contributing

Contributions are welcome! Please fork the repo and open a pull request.

1. Fork the project

2. Create your feature branch (git checkout -b feature/YourFeature)

3. Commit your changes (git commit -m 'Add YourFeature')

4. Push to the branch (git push origin feature/YourFeature)

5. Open a pull request

License This project is open-source and available under the MIT License.