Vagabonds-Labs / cofiblocks

Welcome to Cofiblocks marketplace: A Starknet web3 platform to innovate Costa Rica coffee industry. Cofiblocks connects small coffee farmers directly with coffee lovers, cutting out unnecessary intermediaries.
https://www.cofiblocks.com/
10 stars 20 forks source link

CofiBlocks - La Comunidad del Café ☕️

CofiBlocks is the first Collaborative Business connecting traditional coffee-growing communities in Costa Rica and worldwide directly with coffee lovers using Starknet blockchain technology. Our mission is to distribute benefits among all members, ensuring fair trade, community engagement, and technological innovation.

🌍 What is a Collaborative Business?

A Collaborative Business is an organization where customers, producers, and supporters become members. These members share responsibility, decision-making, and benefits (both monetary and otherwise). Our model represents an evolution of the cooperative and DAO (Decentralized Autonomous Organization) concepts, leveraging blockchain technology, smart contracts, and crypto assets (such as NFTs and social currencies).

🌟 How Does It Work?

Cofi in Your Home

Subscribers receive freshly roasted coffee delivered to their doorsteps monthly, ensuring they enjoy the finest brews while supporting local producers.

Cofi is Fair

Producers receive fair payments upfront, allowing them to plan and understand demand ahead of time, thanks to our subscription model.

Cofi Art & NFTs

In its pilot year, CofiBlocks will create a collection of NFTs featuring original artwork, distributed via coffee labels on each bag sold.

Cofi Complementary Currency

Members of the CofiBlocks pilot community on the Cambiatus app can claim their COFI tokens—a complementary blockchain currency that ensures participation in the Collaborative Business's benefits.

Cofi Distribution

At the end of the first year, all CofiBlocks members will receive a percentage of the pilot's financial results in cryptocurrency based on their accumulated COFI tokens. Members will also have the opportunity to participate in decision-making for future stages of the project.

🔗 CofiBlocks & Cambiatus

CofiBlocks is a proud member of Cambiatus's Social Currency and Collaborative Business Ecosystem.

Learn More About Cambiatus

🚀 CofiBlocks & Starknet

We're building our Web3 marketplace using Starknet technology.

Explore on GitHub

🛠️ Getting Started

Prerequisites

Installation

  1. Clone the repository:

    git clone https://github.com/Vagabonds-Labs/marketplace.git
    cd marketplace
  2. Install dependencies:

    bun install
  3. Generate the Prisma client:

    bun prisma generate
  4. Run the development server:

    bun turbo dev

Project Structure

The project is organized using workspaces:

Key scripts include:

Contributing

We welcome contributions from the community! Here's how you can help:

  1. Fork the repository and create your branch:

    git checkout -b feature/amazing-feature
  2. Commit your changes:

    git commit -m "Add amazing feature"
  3. Push to the branch:

    git push origin feature/amazing-feature
  4. Open a Pull Request.

Code of Conduct

We are committed to creating a welcoming and inclusive environment. Please read our Community Guidelines to ensure a positive experience for everyone involved.

🎉 Join the Community

🚀 Roadmap

2022-2023 Season

Thank you to everyone who participated in our first season and enjoyed coffee from the slopes of Volcán Poás.

2024-2025 Season

We are preparing to launch our second season, featuring coffee from additional coffee-growing regions of Costa Rica.

Want to bring CofiBlocks to your region? Contact Us

👥 Meet the Team

Omar Hurtado Munguia

Co-founder

Omar's journey from coffee picker to coffee tour guide in Poás de Alajuela inspired the creation of CofiBlocks. He brings firsthand knowledge of the challenges small producers face.

Karla Córdoba Brenes

Co-founder

Karla contributes her extensive experience in blockchain technology and impact-driven solutions.

Ranulfo Paiva Sobrinho

Co-founder

Ranulfo's background in blockchain development and collaborative economies helps drive the technical and organizational aspects of CofiBlocks.

🤖 Development Resources

CofiBlocks Dev Assistant

We've created a custom GPT to assist with development tasks related to CofiBlocks. This AI-powered assistant is designed to help with coding, answer questions about our tech stack, and provide guidance on best practices.

Access the CofiBlocks Dev Assistant here: CofiBlocks Dev Assistant

Features:

Feel free to use this resource during your development process to streamline your workflow and get quick answers to your questions.

Prompt Guide

To streamline our development process and maintain consistency across the project, we've created a comprehensive prompt guide. This guide covers various custom prompts designed to assist with component generation, code-related tasks, and information retrieval.

Key features of our prompt guide include:

For full details and usage instructions, please refer to our Prompt Guide.