docs: update readme, add serverless section. (#237)
This commit is contained in:
parent
a20ec8bb22
commit
69ebd36a5b
44
README.md
44
README.md
|
|
@ -1,6 +1,6 @@
|
|||
# Fleek Non Fungible Apps
|
||||
# Fleek Non-Fungible Apps
|
||||
|
||||
**The repository for Fleek Non Fungible Apps project**
|
||||
**The repository for Fleek Non-Fungible Apps project**
|
||||
|
||||
> 🚧 IMPORTANT 🚧 - This initiative is under development, so this repo should be treated as a WIP. The goals and the roadmap might change as the project is shaped.
|
||||
|
||||
|
|
@ -21,44 +21,48 @@ You can find the wiki [here](https://github.com/fleekxyz/non-fungible-apps/wiki)
|
|||
### 📁 Project Structure
|
||||
|
||||
Inside the root folder you are going to find:
|
||||
- [contracts](./contracts): all the developed contracts
|
||||
- [contracts](./contracts): All the developed contracts
|
||||
- [subgraph](./subgraph): The Graph project related code
|
||||
- [ui](./ui): a web application to interact with deployed contracts
|
||||
- [serverless](./serverless): The serverless and Mongo/Prisma set-up
|
||||
- [ui](./ui): A web application to interact with deployed contracts
|
||||
|
||||
You can see breakdowns of other folders in the README within those folders.
|
||||
|
||||
### Contracts
|
||||
|
||||
Within the project is the contracts folder which houses the contracts, utils, tests and deployment scripts associated with the Solidity smart contracts. Check the [contracts readme](./contracts/README.md) for more info.
|
||||
|
||||
|
||||
### 🖥️ User Interface
|
||||
|
||||
Within the project is included a [React](https://reactjs.org/) web application to expose and test the interaction with deployed scripts. Check the [UI readme](./ui/README.md) for more info.
|
||||
Within the project is the contracts folder which houses the contracts, utils, tests, and deployment scripts associated with the Solidity smart contracts. Check the [contracts readme](./contracts/README.md) for more info.
|
||||
|
||||
### Subgraph
|
||||
|
||||
In order to index data offchain, we use TheGraph and this section is the code required for our subgraph. Check the [subgraph readme](./subgraph/README.md) for more info.
|
||||
To index data off-chain, we use TheGraph and this section is the code required for our subgraph. Check the [subgraph readme](./subgraph/README.md) for more info.
|
||||
|
||||
### Serverless
|
||||
|
||||
For verification purposes and our off-chain stack, we are using a MongoDB instance integrated with Prisma and serverless handlers. Check the [serverless readme](./serverless/README.md) for more info.
|
||||
|
||||
### User Interface (UI)
|
||||
|
||||
Within the project is included a [React](https://reactjs.org/) web application to expose and test the interaction with deployed scripts. Check the [UI readme](./ui/README.md) for more info.
|
||||
|
||||
### 💅 Code Styling
|
||||
|
||||
For code formatting we are using [Prettier](https://prettier.io/) and following the [styling guide from Solidity documentation](https://docs.soliditylang.org/en/v0.8.16/style-guide.html). For formatting the code you are able to run:
|
||||
For code formatting, we are using [Prettier](https://prettier.io/) and following the [styling guide from Solidity documentation](https://docs.soliditylang.org/en/v0.8.16/style-guide.html). For formatting the code you can run:
|
||||
|
||||
```
|
||||
$ yarn format
|
||||
```
|
||||
|
||||
> ⚠️ Please make sure you are following the code styling guid before pushing code
|
||||
> ⚠️ Please make sure you are following the code styling guide before pushing the code
|
||||
|
||||
## 🛣️ Roadmap
|
||||
|
||||
Our goal is to reach a point where trustable Solidity contracts can be used for identifying properly the data about web3 applications. Within that goal, we want to also provide ways for users to organize and list information about their application. To get at this we are currently starting with:
|
||||
Our goal is to reach a point where trustable Solidity contracts can be used for identifying properly the data about web3 applications. Within that goal, we want to also provide ways for users to organize and list information about their applications. To get at this we are currently starting with:
|
||||
|
||||
- Define trustable and extendable smart contracts and standards
|
||||
- Prove how the concept would be applicable using static sites
|
||||
- Prove community hosted apps via these contracts
|
||||
- Prove how the concept would be applied using static sites
|
||||
- Prove community-hosted apps via these contracts
|
||||
|
||||
Later on, when the initiative prove its value, a service will be added to Fleek's platform in a friendly way for anyone be able to get their applications onboard.
|
||||
Later on, when the initiative proves its value, a service will be added to Fleek's platform in a friendly way for anyone to be able to get their applications onboard.
|
||||
|
||||
## 💡 Proof of concept
|
||||
|
||||
|
|
@ -66,7 +70,7 @@ The proof of concept was concluded last year and you can reach more information
|
|||
|
||||
## 📚 Dependency Highlights
|
||||
|
||||
We use the following libraries to develop Fleek Non Fungible Apps
|
||||
We use the following libraries to develop Fleek Non-Fungible Apps
|
||||
|
||||
- [Eslint](https://eslint.org/) + [Prettier](https://prettier.io/)
|
||||
- [Ethers](https://docs.ethers.io/v5/)
|
||||
|
|
@ -79,11 +83,11 @@ We use the following libraries to develop Fleek Non Fungible Apps
|
|||
|
||||
## 🙏 Contributing
|
||||
|
||||
This is an open source initiative! Any new idea is welcome, if you want to help us to improve the project please checkout [the contributing guide](/CONTRIBUTING.md).
|
||||
This is an open-source initiative! Any new idea is welcome, if you want to help us to improve the project please check out [the contributing guide](/CONTRIBUTING.md).
|
||||
|
||||
## 📜 License
|
||||
|
||||
Fleek Non Fungible Apps is released under the [MIT License](LICENSE).
|
||||
Fleek Non-Fungible Apps is released under the [MIT License](LICENSE).
|
||||
|
||||
## 🐛 Bug reporting
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue