Install instructions - nicmart-dev/linguistnow GitHub Wiki
Install
To install and run the LinguistNow application, follow these steps in order listed below:
Install front-end and backend
Server
-
Navigate to the
server
directory. -
Install dependencies using npm.
npm install
-
Copy file
example.env
naming it.env
Note: We will start our Express server after setting up Google credentials below.
React app
-
Navigate to the
client
directory. -
Install dependencies using npm.
npm install
-
Copy file
example.env
naming it.env
Note: We will start our app after setting up Google credentials below.
Airtable Database
- Click on Airtable share link https://airtable.com/apps6wMV6ppYNZO2L/shriM67YiDaTMkebK
Note: It will say "No visible records" which is fine.
-
Click "Use this data". This should create your own empty database with the same schema.
-
Navigate back to
server
and in the.env
variableAIRTABLE_BASE_ID
with the url part that starts with "app" -
Create a personal access token https://airtable.com/create/tokens
-
In that same
.env
variable, updateAIRTABLE_PERSONAL_ACCESS_TOKEN
with your token id (begins withpat
)
n8n
Install through npm
-
Ensure you have Node.js and npm installed on your system.
-
Install n8n globally.
npm install n8n -g
-
Start n8n.
n8n start
Configure workflow
-
In the app that opened in your browser, in the first workflow that displays, remove the initial "Trigger node" in an otherwise empty canvas.
-
import n8n workflow configuration from
n8n\Determine_Google_Calendar_availability.json
by clicking the Workflow menu icon > Import from file. -
Notice
Check if busy
node has a warning icon. Double click on it and select Create new credential in Header Auth field:
- Enter any name such as "Authorization", and as value click Expression (in toggle that appears on field mouse over) paste in below code, and click Save:
{{ $('Webhook').item.json["headers"]["authorization"] }}
- Toggle to activate workflow:
Google OAuth setup
Follow steps in https://github.com/nicmart-dev/linguistnow/wiki/Set-up-OAuth-in-Google-Cloud
Start our app
-
Navigate back to the root directory.
-
Install dependencies using npm.
npm install
-
Run
npm start
which will start both React app client and Express server using thenpm-run-all
library.
Note: After following these steps, you should have the LinguistNow application up and running, along with the n8n workflow automation tool.
Set up new users
By default when you run the app http://localhost:3000/
and first sign in with Google, you'll be logged in as a linguist.
We recommend you have two Google accounts so the other can be used to sign in as a Project Manager too and you can then follow the user journey.
To do this:
-
Log in to the app with each Google, account, so the corresponding user row is created in Airtable.
-
Change one of the accounts to have Project Manager role, by logging in to Airtable and then changing role for corresponding user from
Linguist
toProject Manager
.