readme
This commit is contained in:
parent
b1bf47d104
commit
22f3cbafb7
83
README.md
83
README.md
@ -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/`
|
|
||||||
|
Loading…
Reference in New Issue
Block a user