Skip to content

Latest commit

 

History

History
281 lines (199 loc) · 9.74 KB

README.md

File metadata and controls

281 lines (199 loc) · 9.74 KB

Fund Ring

Built by FISSION Discord Discourse


Logo

Fund Ring

Fund Ring is a smart contract standard and set of ready-to-embed components, designed to simplify the process of receiving funding for your project in FIL.

Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

  1. About The Project
  2. Usage
  3. Getting Started
  4. Contributing
  5. License
  6. Contact

About The Project

Do you run a FLOSS project?

Fund Ring is a smart contract standard and set of ready-to-embed components, designed to simplify the process of receiving funding for your project in FIL.

Get a little help from your friends

When you join Fund Ring, you join a broad community of FLOSS projects. It’s like a good ol’ fashioned web ring for funding.

Help shine a light on projects that matter

You have full control over how you connect to the Fund Ring. You can use it to highlight other projects you run or rely on.

Simple to setup

All you need is a git repo and a Filecoin wallet. Our wizard will guide you through the quick setup process.

(back to top)

Built With

(back to top)

Usage

You can try out the app yourself here.

Contributing to the master Fund Ring contract

You can contribute funds to the main Fund Ring project here. Funds from this contract can be used to fund projects the community votes for.

This is an example of the Funding widget that you could instead point to your project's deployed contract:

Fund Ring UI Screenshot

(back to top)

Joining the Fund Ring

You can apply here to have your project join the Fund Ring.

This page will deploy a Fund Ring contract for your project, which you will be the owner of. It will also provide you with the code to embed a Funding widget web-component in your project

Fund Ring Join UI Screenshot

(back to top)

Funding widgets in the wild

(back to top)

Getting Started

Ready? Let's go.

Prerequisites

(back to top)

Installation

  1. Clone the repo
    git clone https://github.com/FundRing/fundring.git
  2. Navigate to project directory
    cd fundring
  3. Install NPM packages
    npm install
  4. Create .env file with PUBLIC_WEB3_STORAGE_KEY="<YOUR_WEB3STORAGE_KEY>"
  5. Start the application in dev mode
    npm run dev

(back to top)

Static Build

Export a static build.

npm run build

The build outputs the static site to the build directory.

(back to top)

Building the widget web-component

If you are making updates to the widget component and want to export it as an embeddable web-component, you can run:

npm run build:web-components

The build outputs fund-ring-widget.js and fund-ring-widget.js.map files to the static directory.

(back to top)

Embedding the Fund Ring widget in your app

Once you have your fund-ring-widget.js file, you can embed it in your app using:

<script src="fund-ring-widget.js"></script>

<fund-ring-widget
  contractAddress="<YOUR_DEPLOYED_FUND_RING_CONTRACT_ADDRESS>"
  title="A title for the widget"
  description="A brief description to display in the body"
/>

Building the smart contracts

  • Install Foundry
curl -L https://foundry.paradigm.xyz | bash
  • Build the contracts
forge build

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License.

(back to top)

Contact

(back to top)