Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/antho31/okp4-ui-boilerplate

🖥️ Vite starter for the OKP4 protocol
https://github.com/antho31/okp4-ui-boilerplate

Last synced: about 1 month ago
JSON representation

🖥️ Vite starter for the OKP4 protocol

Awesome Lists containing this project

README

        

# OKP4 Boilerplate with React + TypeScript + Vite

> Boilerplate to craft UIs that interact with the [@okp4](https://okp4.network) protocol. Refer to the [tutorial for guidance on creating such interfaces](./TUTORIAL.md).

[![lint](https://img.shields.io/github/actions/workflow/status/okp4/template-oss/lint.yml?branch=main&label=lint&style=for-the-badge&logo=github)](https://github.com/okp4/template-oss/actions/workflows/lint.yml)
[![conventional commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg?style=for-the-badge&logo=conventionalcommits)](https://conventionalcommits.org)
[![contributor covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg?style=for-the-badge)](https://github.com/okp4/.github/blob/main/CODE_OF_CONDUCT.md)
[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg?style=for-the-badge)](https://opensource.org/licenses/BSD-3-Clause)

Front-end boilerplate to rapidly develop UIs for interacting with the OKP4 blockchain. Utilizing Vite, it shows how to handle the connection, the interaction with smart contracts, and the decoding of transactions.

![Preview](./src/assets/webapp-7.webp)

---

## 🌟 Features

- Pre-configured setup to connect to OKP4 testnet
- Utility functions and [Graz](https://graz.sh/docs/) hooks to call, deploy, and interact with [OKP4 smart contracts](https://github.com/okp4/contracts)
- Decode transactions to analyze onchain Prolog programs and more

## 🛠 Prerequisites

- Node.js = 18.x

## 🖥 Get started

### Development

To set up and run the project locally, follow the following steps:

```bash
npm i
npm run dev
```

### Deployment

Build and serve the `dist` folder:

```bash
npm i
npm run build
```

To deploy your Vite.js site on decentralized, open technologies that prioritize user control, consider transitioning to Web3 by [hosting on Fleek.co](https://mirror.xyz/joshcstein.eth/UbInedh4ToAAfsDklzSPb3R1_hVSHIdE97hvxIWYlOo) (using the `node:18` Docker Image Name). This not only allows you to set a custom domain name but also benefits from IPFS's censorship-resistant P2P hosting and ENS domain linking.

## 🆘 Support

For bugs 🐛, feature requests 🌈, or other queries ❓, open an issue in the GitHub repository.

## You want to get involved? 😍

Please check out OKP4 health files :

- [Contributing](https://github.com/okp4/.github/blob/main/CONTRIBUTING.md)
- [Code of conduct](https://github.com/okp4/.github/blob/main/CODE_OF_CONDUCT.md)