cfbender/snowballtools-base
1
0
Fork 0
forked from cerc-io/snowballtools-base
Code Pull Requests Activity

readme

Browse Source
This commit is contained in:
Vivian Phung 2024-02-28 17:27:27 -07:00
parent b1bf47d104
commit 22f3cbafb7
No known key found for this signature in database
1 changed files with 29 additions and 54 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

83
README.md
View File

@ -2,44 +2,39 @@
## Setup ## Setup
- Clone the `snowballtools-base` repo ### Clone the `snowballtools-base` repo
```bash ```bash
git clone git@github.com:snowball-tools/snowballtools-base.git git clone git@github.com:snowball-tools/snowballtools-base.git
cd snowballtools-base
``` ```
- In root of the repo, install depedencies ### Install dependencies in root
```bash ```bash
yarn yarn
``` ```
- Build packages ### Build packages
```bash ```bash
yarn build --ignore frontend yarn build --ignore frontend
``` ```
## Backend ### Configuration Files
- Change directory to `packages/backend` - For Backend:
```bash ```bash
cd packages/backend cp packages/backend/environments/local.toml.example packages/backend/environments/local.toml
``` ```
- Rename backend config file from [environments/local.toml.example](packages/backend/environments/local.toml.example) to `local.toml` - For Frontend:
```bash ```bash
mv environments/local.toml.example environments/local.toml cp packages/frontend/.env.example packages/frontend/.env
``` ```
- Set `gitHub.oAuth.clientId` and `gitHub.oAuth.clientSecret` in backend [config file](packages/backend/environments/local.toml)
- Client ID and secret will be available after [creating an OAuth app](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app)
- In "Homepage URL", type `http://localhost:3000`
- In "Authorization callback URL", type `http://localhost:3000/organization/projects/create`
- Generate a new client secret after app is created
### Backend Production ### Backend Production
- Let us assume the following domains for backend and frontend - Let us assume the following domains for backend and frontend
@ -63,24 +58,21 @@
``` ```
- Set `gitHub.oAuth.clientId` and `gitHub.oAuth.clientSecret` in backend [config file](packages/backend/environments/local.toml) - Set `gitHub.oAuth.clientId` and `gitHub.oAuth.clientSecret` in backend [config file](packages/backend/environments/local.toml)
- Client ID and secret will be available after [creating an OAuth app](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app) - [OAuth App Creation](https://github.com/organizations/<org>/settings/applications/new)
- In "Homepage URL", type `https://dashboard.snowballtools.com` - Homepage URL: `https://dashboard.snowballtools.com`
- In "Authorization callback URL", type `https://dashboard.snowballtools.com/organization/projects/create` - Authorization callback URL: `https://dashboard.snowballtools.com/organization/projects/create`
- Generate a new client secret after app is created - Generate a new client secret after app is created
- Set `gitHub.webhookUrl` in backend [config file](packages/backend/environments/local.toml) - Set `gitHub.webhookUrl` in backend [config file](packages/backend/environments/local.toml)
```toml ```toml
...
[gitHub] [gitHub]
webhookUrl = "https://api.snowballtools.com" webhookUrl = "https://api.snowballtools.com"
...
``` ```
- Let us assume domain for Laconicd to be `api.laconic.com` and set the following in backend [config file](packages/backend/environments/local.toml) - Let us assume domain for Laconicd to be `api.laconic.com` and set the following in backend [config file](packages/backend/environments/local.toml)
```toml ```toml
...
[registryConfig] [registryConfig]
fetchDeploymentRecordDelay = 5000 fetchDeploymentRecordDelay = 5000
# Use actual port for REST endpoint # Use actual port for REST endpoint
@ -98,21 +90,14 @@
amount = "200000" amount = "200000"
denom = "aphoton" denom = "aphoton"
gas = "750000" gas = "750000"
...
```
- Start the server in `packages/backend`
```bash
yarn start
``` ```
### Backend Development ### Backend Development
- Set `gitHub.oAuth.clientId` and `gitHub.oAuth.clientSecret` in backend [config file](packages/backend/environments/local.toml) - Set `gitHub.oAuth.clientId` and `gitHub.oAuth.clientSecret` in backend [config file](packages/backend/environments/local.toml)
- Client ID and secret will be available after [creating an OAuth app](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app) - [OAuth App Creation](https://github.com/organizations/<org>/settings/applications/new)
- In "Homepage URL", type `http://localhost:3000` - Homepage URL: `http://localhost:3000`
- In "Authorization callback URL", type `http://localhost:3000/organization/projects/create` - Authorization callback URL: `http://localhost:3000/organization/projects/create`
- Generate a new client secret after app is created - Generate a new client secret after app is created
- Setup Laconicd - Setup Laconicd
@ -159,26 +144,16 @@
- Look for the forwarding URL in ngrok - Look for the forwarding URL in ngrok
```bash ```bash
...
Forwarding https://19c1-61-95-158-116.ngrok-free.app -> http://localhost:8000 Forwarding https://19c1-61-95-158-116.ngrok-free.app -> http://localhost:8000
...
``` ```
- Set `gitHub.webhookUrl` in backend [config file](packages/backend/environments/local.toml) - Set `gitHub.webhookUrl` in backend [config file](packages/backend/environments/local.toml)
```toml ```toml
...
[gitHub] [gitHub]
webhookUrl = "https://19c1-61-95-158-116.ngrok-free.app" webhookUrl = "https://19c1-61-95-158-116.ngrok-free.app"
...
``` ```
- Start the server in `packages/backend`
```bash
yarn start:dev
```
## Frontend ## Frontend
- Change directory to `packages/frontend` in a new terminal - Change directory to `packages/frontend` in a new terminal
@ -187,12 +162,6 @@
cd packages/frontend cd packages/frontend
``` ```
- Rename [.env.example](packages/frontend/.env.example) to `.env`
```bash
mv .env.example .env
```
- Copy the GitHub OAuth app client ID from previous steps and set it in frontend [.env](packages/frontend/.env) file - Copy the GitHub OAuth app client ID from previous steps and set it in frontend [.env](packages/frontend/.env) file
```env ```env
@ -202,9 +171,8 @@
- Set `REACT_APP_GITHUB_PWA_TEMPLATE_REPO` and `REACT_APP_GITHUB_IMAGE_UPLOAD_PWA_TEMPLATE_REPO` in [.env](packages/frontend/.env) file - Set `REACT_APP_GITHUB_PWA_TEMPLATE_REPO` and `REACT_APP_GITHUB_IMAGE_UPLOAD_PWA_TEMPLATE_REPO` in [.env](packages/frontend/.env) file
```env ```env
# Set actual owner/name of the template repo that will be used for creating new repo REACT_APP_GITHUB_PWA_TEMPLATE_REPO = 'cerc-io/test-progressive-web-app' # Set actual owner/name of the template repo that will be used for creating new repo
REACT_APP_GITHUB_PWA_TEMPLATE_REPO = cerc-io/test-progressive-web-app REACT_APP_GITHUB_IMAGE_UPLOAD_PWA_TEMPLATE_REPO = 'cerc-io/image-upload-pwa-example' # Set actual owner/name of the template repo that will be used for creating new repo
REACT_APP_GITHUB_IMAGE_UPLOAD_PWA_TEMPLATE_REPO = cerc-io/image-upload-pwa-example
``` ```
### Frontend Production ### Frontend Production
@ -216,8 +184,7 @@
- Set the following values in [.env](packages/frontend/.env) file - Set the following values in [.env](packages/frontend/.env) file
```env ```env
# Backend server endpoint REACT_APP_SERVER_URL = 'https://api.snowballtools.com' # Backend server endpoint
REACT_APP_SERVER_URL = 'https://api.snowballtools.com'
``` ```
- Sign in to [wallet connect](https://cloud.walletconnect.com/sign-in) to create a project ID - Sign in to [wallet connect](https://cloud.walletconnect.com/sign-in) to create a project ID
@ -260,10 +227,18 @@
REACT_APP_WALLET_CONNECT_ID = <Project_ID> REACT_APP_WALLET_CONNECT_ID = <Project_ID>
``` ```
- Start the React application - The React application will be running in `http://localhost:3000/`
## Development
- Start the backend server
```bash
yarn start:backend
```
- Start the frontend
```bash ```bash
yarn start yarn start
``` ```
- The React application will be running in `http://localhost:3000/`