Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Talentum-id/formify
Fully on-chain decentralized Q&A Application
https://github.com/Talentum-id/formify
internet-computer motoko vuejs
Last synced: 3 months ago
JSON representation
Fully on-chain decentralized Q&A Application
- Host: GitHub
- URL: https://github.com/Talentum-id/formify
- Owner: Talentum-id
- License: other
- Created: 2023-12-11T17:10:12.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2024-05-27T12:14:06.000Z (5 months ago)
- Last Synced: 2024-05-27T13:40:31.690Z (5 months ago)
- Topics: internet-computer, motoko, vuejs
- Language: Vue
- Homepage: https://formyfi.io/
- Size: 2.38 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-motoko - Formyfi - Decentralized & fully on-chain Q&A Forms. (Applications / Social)
- awesome-internet-computer - Formyfi - Decentralized & fully on-chain Q&A Forms. (Social Applications / Protocols)
README
# Formyfi
Formyfi is a robust Q&A application fully running on the Internet Computer blockchain.
## Prerequisites
If you are using the Windows operating system, please ensure that you have WSL
(Windows Subsystem for Linux) installed on your machine, as all the code below should be executed in the WSL terminal.
Before getting started with Formyfi, ensure you have the following tools installed:
#### DFX 0.15.2
To install DFX 0.15.2, run the following command:
```bash
DFX_VERSION=0.15.2 sh -ci "$(curl -fsSL https://sdk.dfinity.org/install.sh)"
```
#### NPM
Download and install NPM from [https://nodejs.org/en/download](https://nodejs.org/en/download).
#### Web2
There is certain functionality implemented in web2 for this project. If you are interested to see web2 part, run the following code:
```bash
git clone --recursive
```
---
## There are 2 ways to run and stop the project locally - Manual (I) and Automatic (II)
## I. Running Manually
1. Navigate to the project directory and start DFX using the following command:
```bash
dfx start --clean --background
```
> **Note:** If starting DFX returns an error, open the `dfx.json` file, remove "local" from "networks," and run:
```bash
dfx start --clean --background --host 127.0.0.1:4943
```
2. Install project dependencies by running:
```bash
npm install
```
Ensure to add "local" back to the "networks" section in `dfx.json` if you removed it while starting DFX.
3. Deploy the canisters locally with:
```bash
dfx deploy
```
Previous command may return an error, so don't worry about it, we will run it again later.
Our project uses SIWE (Sign-In With Etherium), so for it to operate properly, run `ic_siwe_provider` canister individually with runtime configurations:
```bash
dfx deploy ic_siwe_provider --argument $'(
record {
domain = "127.0.0.1";
uri = "http://127.0.0.1:3000";
salt = "WjcIMw9vpXTcpSD/uGtOZmLLGbYCKVe6njceNLqKjt4=";
chain_id = opt 1;
scheme = opt "http";
statement = opt "Login to the app";
sign_in_expires_in = opt 2592000000000000;
session_expires_in = opt 2592000000000000;
targets = opt vec {
"'$(dfx canister id ic_siwe_provider)'";
"'$(dfx canister id assets)'";
};
}
)'
```
Lastly, for completeness and Front-end to work with canisters, run:
```bash
dfx deploy && dfx generate
```
After deployment, you will receive URIs for the canisters. Click on the URI for the `assets` canister to open the local DApp in your browser.
4. Need to start assets canisters for uploading and reading files like images, run:
```bash
dfx canister call user_storage authorize '(principal "m7ob5-xdzun-z3vt2-6oujc-gfm2t-2lt5p-bw5kn-2tatc-fjkti-eko6j-jqe")'
dfx canister call qa_storage authorize '(principal "m7ob5-xdzun-z3vt2-6oujc-gfm2t-2lt5p-bw5kn-2tatc-fjkti-eko6j-jqe")'
dfx canister call response_storage authorize '(principal "m7ob5-xdzun-z3vt2-6oujc-gfm2t-2lt5p-bw5kn-2tatc-fjkti-eko6j-jqe")'
```
Open the DApp through the link provided by the Vite dev server.
5. If you are developing the front-end of the DApp and want to avoid running `dfx deploy` every time you make changes, run:
```bash
npm run dev
```
Open the DApp through the link provided by the Vite dev server.
## I. Stopping Manually
1. Before stopping canisters, ensure that the "local" is removed from the "networks" section in your `dfx.json` file, if you removed it while
starting DFX and added it back during deployment, then run following command:
```bash
dfx stop
```
2. After stopping the canisters, if you removed "local" earlier, make sure to add it back to the "networks" section in your `dfx.json` file:
***
## II. Running Automatically
1. ```bash
make start
```
## II. Stopping Automatically
1. ```bash
make stop
```