An open API service indexing awesome lists of open source software.

https://github.com/aelabassi/artculthub


https://github.com/aelabassi/artculthub

Last synced: about 1 year ago
JSON representation

Awesome Lists containing this project

README

          

# **ArtCultHub Marketplace**


ArtCultHub Logo

**ArtCultHub** is an NFT and digital art and culture marketplace that aims to connect Moroccan artists and artisans with a global audience. The platform enables users to showcase and sell digital versions of traditional crafts, including NFTs of cultural art, promoting Moroccan heritage while supporting local artists.

---

## **Live Demo**
- [Deployed on Vercel](https://art-cult-hub.vercel.app/home)

---

## **API Documentation**
- [ArtCultHub API Docs](https://bump.sh/aelabassapi/doc/artculthubapi)

---

## **Features**

- **Frontend:** Developed with React.js for a dynamic and responsive user interface.
- **Backend:** Powered by Node.js/TypeScript, Mongodb, and mongoose for models schema.
- **Marketplace Functionalities:**
- Browse and search for art.
- Add items to a wishlist or purchase directly.
- Artist profiles showcasing their collections.
- **NFT Integration:** Option for artists to tokenize their work as NFTs.
- **Localization:** Tailored design and language support for Moroccan culture.

---

## Technologies
### **Frontend**
- HTML5
- CSS3
- Javascript
- React
- Redux

### **Backend**
- Node.js
- TypeScript
- MongoDB
- Mongoose (ORM)

### **Other Tools:**
- **Visual Studio** for collaborative coding.
- **Discord & WhatsApp** for communication and planning.
- **Git and GitHub** for version control.
- **Figma** for prototyping and mockups.
- **[Trello](https://trello.com/invite/b/675dde7e52ce2e36d4d2828e/ATTI35269f08da0837b3b660704362c0d015037307F2/artculthub)** for project management.

---

## Team Members
| Name | Role | LinkedIn | GitHub |
|-------------------|------------------------|----------------------------------------------|---------------------------------------------|
| **Layla Abkari** | Frontend Developer | [LinkedIn Profile](https://www.linkedin.com/in/layla-abkari-5505301a3/) | [GitHub Profile](https://github.com/Lelaabk) |
| **Chaimae Aafif** | Frontend Developer | [LinkedIn Profile](https://www.linkedin.com/in/aafif-chaimae-911372150/) | [GitHub Profile](https://github.com/blackpearlRZ) |
| **Abderrazaq El Abassi** | Backend Developer | [LinkedIn Profile](https://www.linkedin.com/in/el-abassi-abderrazaq/) | [GitHub Profile](https://github.com/aelabassi) |
| **Nancy Kibara** | Backend Developer | [LinkedIn Profile](https://www.linkedin.com/in/nancy-kibara952595/) | [GitHub Profile](https://github.com/nancie6695) |

---

## Getting Started
### Prerequisites
- Node.js
- npm or yarn

### Installation
1. Clone the repository:
```bash
git clone https://github.com/aelabassi/ArtCultHub.git
cd ArtCultHub
```

2. Install dependencies for the frontend:
```bash
cd frontend
npm install
```

3. Install dependencies for the backend:
```bash
cd backend
npm install
```

### Running the Application
1. Start the frontend:
```bash
cd frontend
npm start
```

2. Start the backend:
```bash
cd backend
npm run start
```

---

## **Branching Strategy**

- **Frontend Branches:**
- `feature/dashboard`: For dashboard development.
- `gh-pages`: For deployment-related branches.
- `artFrontend`: For all frontend development.

- **Backend Branches:**
- `artBackup`: For backup-related work.
- `db/mongodb`: For MongoDB-related changes.
- `feature/auth`: For user authentication features.
- `feature/paypal_pay`: For integrating PayPal payment functionality.
- `tests/aelabassi/auth`: For authentication-related tests.
- `artBackend`: For all backend development.

- Team members must create features or bug fixes on separate branches based on the main frontend or backend branches.
- Use Pull Requests (PRs) for merging changes into the main branch.

---

## Project Goals
1. Build a functional prototype of the marketplace.
2. Ensure a responsive and visually appealing UI/UX.
3. Implement secure user authentication and payment systems.
4. Explore and integrate NFT features for unique digital art sales.

---

## Roadmap
- **Week 1:** Set up project infrastructure, initialize frontend/backend.
- **Week 2:** Develop core features (marketplace browsing, artist profiles).
- **Week 3:** Implement NFT integration and testing.
- **Week 4:** Finalize, test, and deploy.

---

## License
This project is licensed under the [MIT License](LICENSE).