Internal Use Only - WCR Development Team
1. Prerequisites
Ensure your system meets all required dependencies before proceeding with the setup.Required Utilities
| Utility | Required Version | Verification Command |
|---|---|---|
| Node.js & npm | v18 or higher | node --version / npm --version |
| Git | Any modern version | git --version |
| IDE | VS Code, Cursor, etc. | N/A |
Download Node.js
Node.js can be downloaded from the official website
Note on Angular CLI: We utilize
npx (Node Package Execute) to automatically run the project’s locally specified version of the Angular CLI (ng), eliminating the need for a global installation.2. Quick Start Workflow
This section provides a condensed workflow for experienced users:1
Clone Repository
2
Configure Hosts
Modify
/etc/hosts (or equivalent) to add 72.144.25.104 mappings3
Update Config
Replace the contents of
src/environments/environment.ts (see Section 3.3)4
Install
5
Serve
6
Access
Open
http://localhost:42003. Detailed Setup Instructions
These steps should be executed within your desired working directory.Step 3.1: Clone the Frontend Repository
Acquire the WCR frontend code from the official GitHub repository. Navigate to your preferred development folder. Run the clone command and move into the project directory:Step 3.2: Configure /etc/hosts
This crucial step ensures that your local machine resolves the dev server domains directly to the correct IP address, bypassing public DNS.- macOS / Linux
- Windows
Open your hosts file in Terminal (requires administrator/root password):Add the following line at the bottom of the file:Save and exit: Press
Ctrl+X, then Y (for Yes), then Enter.Step 3.3: Update Environment Configuration
Edit the environment file:getme.global dev server:
src/environments/environment.ts
Ctrl+X, Y, Enter).
Configuration Reference
| Setting | Value | Purpose |
|---|---|---|
baseUrl | https://getme.global/ | Main dev server backend URL |
apiUrl | https://getme.global/api/v1/ | API endpoints |
wsBase | wss://getme.global/cable | Secure WebSocket connection |
jitsiUrl | jitsi.getme.global | Video conferencing service domain |
Step 3.4: Install Dependencies
Execute this command inside your project directory (wcr.is):
package.json.
Troubleshooting: Dependency Errors
Troubleshooting: Dependency Errors
If you encounter dependency or peer-dependency errors, try one of the following commands:
4. Running the Application
4.1 Start the Development Server
Start the Angular development server using the Angular CLI command: Run the command:4.2 Access the Application
Wait for the terminal output indicating successful compilation:1
Open your browser
2
Navigate to
3
Login
The WCR login page should load, running the frontend locally and connected to the remote dev backend.Test Credentials:
- Email:
[email protected] - Password:
password123
To stop the running server, press
Ctrl + C in the terminal window.