IKalonji/SwarmFairOsIPFSDapp

Mobile Decentralized Storage

An awesome lightweight decentralized mobile storage dapp deployed on Kardiachain!
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

About The Project
- Built With
Getting Started
- Prerequisites
- Installation
Usage
Roadmap
Contributing
License
Contact
Acknowledgments

Live Demo

https://mobile-dstorage.vercel.app/

About The Project

Mobile Decentralized Storage is a dapp that allows for starage on the go.

Here's why:

Simple to use.
Lightweight
3 decentralized cloud storage providers

(back to top)

Built With

(back to top)

Notice

This project is not audited and should not be used in a production environment.
The project was built on Windows and has not been tested on any Linux distro, but it should run since the tools used are cross platform.

Getting Started

Follow the steps below on how to run the project.

Prerequisites

Please install the below required software in order to run the project.

NodeJs NodeJS
Bee node Swarm
FairOS Node FairOS
ionic
```
npm install -g @ionic/cli
```
Install Android Studio Android Studio
Add Kardiachain demo wallet private key to hardhat.config.js
```
const PRIVATE_KEY = "PRIVATE KEY HERE";  
```
Physical Android device

Installation

Clone the repo

git clone https://github.com/IKalonji/SwarmFairOsIPFSDapp.git

cd into the Ionic frontend install dependecies then paste the necessary keys in the environment.ts as well as the enviroment.prod.ts files:
```
cd SwarmFairOsIPFSDapp
npm install
```
Now, we can build the frontend with Ionic and create an APK with Android Studio. In the terminal run:
```
ionic capacitor build android
```
Android Studio should open automatically once the build is complete. If not open the Ionic/Frontendandroid folder in Android Studio.
Finally, use one of the two options to run the app:
- Option 1: In Android Studio, click on the build tab in the navigation bar and select 'Generate APK'. Complete the steps and navigate to the folder where the APK was generated. Send the APK to your Android device and install.
- Option 2: Connect an Android device to your PC and select your device under the devices section of the navigation bar, then run the app.

(back to top)

Usage

Unstoppable Domains Integration

Video Demo

Please refer to the Documentation

(back to top)

Roadmap

[ ] Pods
[ ] Share files

See the open issues for a full list of proposed features (and known issues).

(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!