Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
PiOS License

Copyright (C) <year> <copyright holder>
Copyright (C) <2025> <Fodubu CoreTeam>

Permission is hereby granted by the application software developer (“Software Developer”), free
of charge, to any person obtaining a copy of this application, software and associated
Expand Down
222 changes: 189 additions & 33 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,47 +1,203 @@
# Pi Open Source (PiOS)
To view a list of open source Pi applications and libraries navigate to the [PiOS App List](/list.md)

To learn more about Pi Open Source and how to utilize it continue reading
FODUBU Unified Applications

## The License
The Pi Open Source Software License allows [Pi Community](https://minepi.com) Developers to create open source applications and tools for the Pi Ecosystem and foster collaboration among Pi community developers. In contrast to the MIT license the PiOS license grants unrestricted use of the software only within the Pi Ecosystem. Developers are encouraged to use this license when developing a Pi App.
Project Title

## Creating a PiOS application
FODUBU – Unified Pi-Powered Applications (PiOS)

We are offering projects github hosting under the `pi-apps` organization so that projects can be found easily. To request your own repo follow the steps below:
Overview

### 1. Submit a PR to the PiOS App List
Create a PR on this repository adding your application's information to the [PiOS App List](/list.md) table. Follow the formatted row template given on that doc, and fill in the below information as incomplete submissions will be rejected.

Information necessary for the PR to be approved:
- Category (If you need a new Category add it directly in the PR)
- Title
- Can be in the form of “App_Name for Pi”, “App_Name on Pi”, “App_Name”, but not in the form of “Pi App_Name”
to avoid confusion with apps developed by the Pi Core Team
- You must include the following language in your code: Pi, Pi Network and the Pi logo are trademarks of the Pi Community Company.
- Description - Short description about what the application aims to achieve
- Programming Languages + Framework to be used
- Link to Pi Brainstorm project proposal (project name until feature is ready)
FODUBU (Force de Développement et Ubuntu au Burundi) is a Pi Network–powered utility organization and multisector company building decentralized applications (DApps) that enable real economic activity through trade, agriculture, and environmental sustainability.

Information NOT necessary for the PR to be approved:
- Link To Repo - Core Team will fill this in upon PR approval
- Link to Testnet App - Project admin to send new PR later when available
- Link to Mainnet App - Project admin to send new PR later when available
This Pi Open Source (PiOS) submission covers the FODUBU Unified Applications, a suite of three interoperable Pi-powered marketplaces that use Pi as the primary means of payment.

### 2. Pi Core Team will approve PR and create repository
We will approve your PR, create a repository under github.com/pi-apps and invite you as the admin of that repository.
🌍 Mission & Vision

The github user that submits the Pull Request to the PiOS Application Library table will be given admin privileges to this newly created repository. This will grant you full admin access to the repository to add additional team members, and perform any sensitive or destructive actions like managing security, moving or even deleting the repository.
Mission
To power inclusive trade, agricultural growth, and environmental sustainability using Pi Network as a decentralized payment and utility layer.

Other Pi community developers can also contribute to the maintenance and improvement of the application and submit Pull Requests directly to the project. As the admin you will be responsible for responding to those PRs or you can delegate this responsibility to your team members. Even though the Pi Core Team is providing you access to the github.com/pi-apps namespace for convenience, it will not maintain your repository or application code. You are fully responsible for your code.
Vision
To become a trusted Pi-powered digital infrastructure for trade and development across communities and markets.

In the future should you wish to remove your application from the Pi Open Source Library you will be able to do this by simply moving your project out and sending a PR to remove the link to your code from the list. As an admin of your repository you can move it or remove it anytime without the approval of the Pi Core Team.

### 3. Edit License in your application's code repository and start coding
To add the license to your code follow the below steps:
- Edit the Copyright line of the LICENSE file in your repo
🧩 Applications Covered (3 DApps)

Note: source of the PiOS license is also available here [https://github.com/pi-apps/PiOS/blob/main/LICENSE](https://github.com/pi-apps/PiOS/blob/main/LICENSE)
1️⃣ FODUBU – Main Unified App

#### Disclaimer
This is just a suggested license to limit use of your Software to Pi Network applications. Pi Network does not take any responsibility for the use of this license by you or others. All developers should consult their own counsel to ensure the license meets their needs and are solely liable for all consequences arising from the use of the license. To be included in the PiOS app list you are required to use this license without alterations, aside from the copyright notice. If you make alterations or use a different license, you may still be eligible to be included in other lists that may be established at some later time by Pi Network.
Central marketplace and utility hub

Trade and service aggregation

Entry point to the FODUBU ecosystem


2️⃣ TRACO – Agri-Connect Marketplace

(Trade-Agri-Connect)

Digital agricultural marketplace

Buying and selling of agricultural products

Seed distribution to branches and farmers

Agricultural value-chain connectivity


3️⃣ SETRA – Eco Marketplace

(Save Environmental Trade)

Environment-focused marketplace

Sustainable and eco-friendly trade

Promotion of environmental responsibility through commerce


💱 Pi Network Integration

All FODUBU applications:

Use Pi as the means of payment

Run inside the Pi Browser

Integrate Pi authentication

Verify payments via secure backend validation


> Important Disclaimer
FODUBU is an independent community-built project.

Pi, Pi Network, and the Pi logo are trademarks of Pi Community Company.
This project is not affiliated with nor endorsed by Pi Network Core Team

🏗 Technical Architecture

Frontend

ReactJS

Vite

Pi JavaScript SDK (@pi-apps/pi-sdk)

Pi Browser–compatible UI


Backend

Node.js

Express.js

Pi Backend SDK (@pi-apps/backend)

Stellar SDK (@stellar/stellar-sdk)

Secure Pi payment verification


Database & Infrastructure

MongoDB Atlas

Environment-based configuration

CI-ready structure


🔗 Repositories & Links

Backend (Unified API)

FODUBU Unified API
https://github.com/FODUBU/fodubu-api


Pi Brainstorm

FODUBU Pi Brainstorm Project
https://brainstorm.pinet.com/project/68b6d0be045f663593b54b34


Live Frontends

FODUBU Trade Portal
https://trade.fodubu.com

TRACO Marketplace
https://traco.fodubu.com

SETRA Marketplace
https://setra.fodubu.com

🔐 Security & Compliance

All Pi payments are verified server-side

Secrets are managed via environment variables

No private keys are exposed in frontend code

Backend follows Pi Network payment verification flow

Repository includes:

SECURITY.md

.env.example

Controlled access for production secrets

Review & Transparency

Core backend is maintained in a private repository

Read-only access or temporary reviewer access can be granted upon request

CI pipelines are used for:

Code quality checks

Build verification


Public documentation and architecture are fully transparent

Open Source & Community

This project supports:

Open standards

Community contributions

Ethical development principles

Respect for Pi Network ecosystem rules


Contribution guidelines and code of conduct are provided in the repository.

📜 License

This project is released under the MIT License, allowing open use, modification, and distribution while protecting contributors.

Summary

FODUBU PiOS represents a real-world Pi utility ecosystem combining:

Trade

Agriculture

Environmental sustainability


All powered by Pi Network, built with modern web technologies, and designed for scalable, secure, and inclusive commerce.

© FODUBU — Force de Développement et Ubuntu au Burundi
6 changes: 4 additions & 2 deletions list.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,8 +26,8 @@ To add your project to the list follow the instructions [here](/README.md)

### Adding a new row to the table
**To add a new row copy the formated line below, paste a copy onto the line below the last row of the Pi-OS contributions table and update it with your app's information**
| Title | Description | Category | Programming Language/Framework | Updated by Pi-CT |Brainstorm link | (When available) | (When available) |

| Demo | This application showcases the authentication and payment functionalities of the Pi SDK. | Consumer Utility | , MongoDB | [demo](https://github.com/pi-apps/demo) | N/A | [pi://demo.pi](pi://demo.pi) | N/A |
| Pi Commerce Apps | Mock Ups and Material for the Pi Commerce Hackathon in 2024 | Social Media | Figma | [pi-commerce-app](https://github.com/pi-apps/pi-commerce-app)| | | |

### Potential App Categories
- Social Media
Expand Down Expand Up @@ -84,3 +84,5 @@ To add your project to the list follow the instructions [here](/README.md)
| BLIYYAN | A marketplace that was founded at the urging of pioneers who needed a means to exchange pi currency for the goods and services they needed.We are ready to serve and provide all pioneer needs, we will immediately present all product proposals on our market.Together we fight for the success of the PiNet project. | Marketplace | PHP/Laravel, JS/Vue, DB/Mysql | [bliyyaan](https://github.com/bliyyaan/bliyyaan) | [https://brainstorm.pinet.com/project/67a468399b2522003c31de97](https://brainstorm.pinet.com/project/67a468399b2522003c31de97) | [BLIYYAAN TESTNET](https://test.bliyyaan.com) | [BLIYYAN MAINNET](https://bliyyaan.com) |
| BLJ FOR PI| Berkah Lestari Jambi (BLJ FOR PI) is a application used to conduct buying and selling transactions using Pi as the means of payment | Marketplace | ReactJS - Laravel, MYSQL| [BLJ FOR PI](https://github.com/Berkahlestarijambi/Berkahlestarijambi)| [https://brainstorm.pinet.com/project/671ccd37ed1252004d30e295](https://brainstorm.pinet.com/project/671ccd37ed1252004d30e295)|[Testnet](https://testnet.bljambi.com)|[Mainnet](https://mainet.bljambi.com) |
| Orbit | Post once, share everywhere, track growth, and get AI insights. Your all-in-one social management tool. | Business tool | JS/React | [Orbit](https://github.com/pi-apps/orbit) | https://brainstorm.pinet.com/project/68c9638fd8dec8dc8f3bce00 | [Testnet](https://orbit-test.web.app) | [Mainnet](https://tryorbit.web.app) |
|FODUBU,TRACO,SETRA| Fodubu Global Powering Trade;Growth with Pi is an Utility Organisation Application and Multisector Company that working in 3 Dapps all in one used to conduct buying and selling transactions using Pi as the means of payment | Marketplace | ReactJS/vite,pijavascript/sdkjs,Pi-nodejs/express ,Atlas| [FODUBU-UNIFIED-API](https://github.com/FODUBU/fodubu-api)||(https://brainstorm.pinet.com/project/68b6d0be045f663593b54b34)| |when available||when Available|