9058c8af1d
instead of jamserver.js instead of jamserver_copy.js when loading react.js front end. jamserver_copy for some reason desn not load all of the javascripts needed to get for example subscription messages to be captured in the front end. |
||
|---|---|---|
| .. | ||
| cicd | ||
| cypress | ||
| public | ||
| src | ||
| test | ||
| .browserslistrc | ||
| .env.development | ||
| .env.development.example | ||
| .env.production | ||
| .env.staging | ||
| .eslintrc.json | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| .nvmrc | ||
| .prettierrc | ||
| .python-version | ||
| README.md | ||
| cypress.config.js | ||
| cypress.env.json | ||
| gulpfile.js | ||
| package-lock.json | ||
| package.json | ||
| playwright.config.ts | ||
| server.js | ||
README.md
JamKazam new react frontend UI/UX
jam-ui is a react app created using create-react-app utility. to run the app on your development environment you need to cd jam-ui and run npm run start
The changes to the source files are auto-loaded but sometimes you might need to force close it by crtl+c and then start manually.
The application files goes under src and the react components are placed under src/components directory. We have a convention of naming the files using JK prefix in the filename. For example JKMusicSessions.
The routes are defined in jam-ui/src/components/dashboard/JKDashboardMain.js
Running react app
In production this React app is supposed to run on beta.jamkazam.com subdomain which is same origin domain to the production Rails app (www.jamkazam.com). This way we utilize same session based user authentication of Rails web app for authenticating users. (It looks for remember_token session cookie in headers and if it is not availale redirect the user to Rails web app sign in page)
The DOMAIN and PORT running this app is defined in env.production file. This file also has env variables for connecting with Rails app. (When setting up in development you can copy the content of env.development.example in to env.development.local and change them according to your host setup)
HOST=beta.jamkazam.local PORT=4000 REACT_APP_CLIENT_BASE_URL=http://www.jamkazam.local:3000 REACT_APP_API_BASE_URL=http://www.jamkazam.local:3000/api
Subdomains setup (development)
You need 2 host records created for React and and Rails app. For example
127.0.0.1 www.jamkazam.local #for Rails app 127.0.0.1 beta.jamkazam.local #for React app
Installing npm dependencies
cd jam-ui npm install
Running the app
cd jam-ui npm run start
This will open it in a borwser window at http://beta.jamkazam.local:3000. Of course for it to work you also need Rails (web) app and websocket app (websocket-gateway) running.