Skip to content

EmmanuelAR/art-peace

Β 
Β 

Repository files navigation

art_canvas

Collaborative art canvas on Starknet

Check Workflow Status Build Workflow Status

Exploration_Team

Overview

art/peace is a collaborative art game where users can place pixels on a large shared canvas and receive rewards for collaborating to build art. The game will run over X days, and end with a final snapshot of the board. The goal is to give users the feeling of collectively building on a highly responsive art canvas, which they can explore, interact with, and compete on.

Some of the features include :

  • Placing Pixels : This will be the main user interaction, where every X minutes a user will be allowed to place a pixel onto the canvas.
  • Quests : Tasks to get extra pixels to place on-top of the one every X minutes.
  • Voting : In addition to the base colors, there will be a vote to add new colors to the palette every day.
  • Templates : Artwork templates used to help communities collaborate on an art piece. Bounties can be added to a template to incentivize creation.
  • NFTs : Mint NFTs from the canvas.

Running

Docker Run ( Recommended )

docker compose up

To stop the run use Ctrl-C.

For a complete reset of the state and rebuild of the containers use :

# WARNING! This will clear the state (volumes) of all the DBs and the Devnet
docker compose down --volumes
docker compose build

Local Run

# Must install all the dependencies first
# Use npm install inside the `frontend` directory
# Change the user on `configs/database.config.json` for postgres
make integration-test-local

To stop the run use Ctrl-C.

Component Run

Each component can also be run individually, check the Components section below for more details.

Build

Docker Build ( Recommended )

docker compose build

Local Build

make build

Component Build

Use the make build-X command for each corresponding component X. See the Components section below for more details.

Components

  • Onchain: Starknet contract(s) for trustless onchain interactions.
  • Backend: Monolithic Go backend for managing requests, interactions, and DBs.
  • Frontend: Reactjs application for users to interact with.
  • Indexer: Apibara indexer for monitoring Starknet events and forwarding to the DBs.
  • Postgres: DB for storing general data used for analytics, frontend, and backend.
  • Redis: In memory DB used to store the compressed Canvas data for fast retrieval
  • tests: Integration tests for local, docker, ...

art/peace diagram

Dependencies

Its recommended to use docker compose when building and running, so the only dependencies would be docker and docker compose

However, it might be worth running only certain components for development/testing sometimes. Each component has various dependencies, check dependencies.txt for more details.

References

Contributors ✨

Thanks goes to these wonderful people. Follow the contributors guide if you'd like to take part.

Brandon R
Brandon R

πŸ’»
Adeyemi Gbenga
Adeyemi Gbenga

πŸ’»
Tristan
Tristan

πŸ’»
Abdulhakeem Abdulazeez Ayodeji
Abdulhakeem Abdulazeez Ayodeji

πŸ’»
Trunks @ Carbonable
Trunks @ Carbonable

πŸ’»
ptisserand
ptisserand

πŸ’»
Mubarak Muhammad Aminu
Mubarak Muhammad Aminu

πŸ’»
0xK2
0xK2

πŸ’»
Fishon Amos
Fishon Amos

πŸ’»
Xaxxoo
Xaxxoo

πŸ’»
Mano.dev
Mano.dev

πŸ’»
Abdulsamad sadiq
Abdulsamad sadiq

πŸ’»
Agada Gabriel
Agada Gabriel

πŸ’»
Abdulqahar Usman
Abdulqahar Usman

πŸ’»
Awe Olumide David
Awe Olumide David

πŸ’»
Catherine Jonathan
Catherine Jonathan

πŸ’»
Emmaunuel Ejembi
Emmaunuel Ejembi

πŸ’»
CollinsC1O
CollinsC1O

πŸ’»
Alfred Emmanuel
Alfred Emmanuel

πŸ’»
princeibs
princeibs

πŸ’»
Oshioke Salaki
Oshioke Salaki

πŸ’»
Caleb
Caleb

πŸ’»
Immanuelolivia
Immanuelolivia

πŸ’»
Stephanie Nwankwo
Stephanie Nwankwo

πŸ’»
Joy Adah
Joy Adah

πŸ’»
Na'omi Emmanuel Gift
Na'omi Emmanuel Gift

πŸ’»
Yusuf Habib
Yusuf Habib

πŸ’»
drspacemn
drspacemn

πŸ’»
Emmanuel A Akalo
Emmanuel A Akalo

πŸ’»
Kenee Patel
Kenee Patel

πŸ’»
BillXJ
BillXJ

πŸ’»
Jemiiah
Jemiiah

πŸ’»
Umar I Salihu
Umar I Salihu

πŸ’»
Add your contributions

This project follows the all-contributors specification. Contributions of any kind welcome!

About

Collaborative art canvas on Starknet

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 31.4%
  • Cairo 26.6%
  • Go 22.0%
  • Shell 10.3%
  • CSS 8.7%
  • Makefile 0.4%
  • Other 0.6%