A web app for selling items and promoting events locally. This is a multi-page React application
- Project Overview
- Tech Stack
- Installation & Setup
- Running the Project
- Testing
- Architecture
- Contribution Guidelines
- Design Decisions
Use this link to visit site: https://csci423project1.netlify.app/
This app allows users to:
- Buy and sell items within the community
- Promote and express interest in events
- Frontend: React with MUI, Tailwind CSS
- Build Tool: Vite
- Routing: React Router v6
- State Management:
- Backend: Firebase (Authentication, Firestore Database)
Firebase is a BaaS used to simplify auth, storage, and database management
MUI is a component library used for faster UI development. Supports responsive design and theming
- Clone the repo:
git clone <repo-url>- Navigate to project folder
cd project1- Install dependencies
npm install- Run project
npm start- Opens localhost
- Default landing page: Home page with nav and popular items
No current automated tests
src/
├─ components/ # Reusable UI elements like Button, Nav, NavItem, Footer
├─ sign-in # Integrates Firebase authentication
├─ sign-up # Handles input validation and Firebase account creation
├─ shared-theme # Generalized theme integration for MUI components
├─ pages/ # Page-level components: Home, Shop, Community
├─ App.jsx # Root component with routing
├─index.css # Tailwind imports
└─ index.jsx # Entry point
index.html # Vite HTML entry
vite.config.js # Vite configuration
NavItem.jsx was created to allow reusable navigation links and simplify Nav.jsx. This improves scalability if additional links are added.
- Tailwind for fast, responsive styling
- React Context for simple state management
- React MUI and Firebase for faster development
- Routing handled by React Router
- Vite for fast development server and build
Developed by:
Sylvia Hutzler and Kaylee Wood
Course:
ESOF 423
Semester:
Spring 2026