Mac OSX

You can set up and configure a QuickMeet.Chat development environment on your macOS system, whether it’s running on Apple Silicon or non-Apple Silicon chips.

Prerequisites

Install the following:

• Yarn

• Meteor

• Homebrew

• Install Node Version Manager (nvm) with this command:

  brew install nvm

  Confirm that your nvm version is 0.39.2 or higher by running the command nvm --version in your terminal.

• Install Deno by running:

  curl -fsSL https://deno.land/install.sh | sh

  For alternative installation scripts, check the official Deno installation documentation.Setting up Meteor

Setting up Meteor

1. Install Meteor with the command below -  replacing x.x with the correct version number:

   curl https://install.meteor.com/?release=x.x | sh

   Note: Depending on the QuickMeet.Chat version, you may need to install a specific Meteor version:

   • For QuickMeet.Chat <=6.x.x, use Meteor 2.x

   • For QuickMeet.Chat >=7.x.x, use Meteor 3.x

   Always verify the required Meteor version for your QuickMeet.Chat instance by checking the .meteor/release.

2. After installation, verify the version by running:

   meteor --version

   You should see the installed version displayed in your terminal.

Set up a QuickMeet.Chat development environment on MacOS Apple Silicon chip

1. Fork the QuickMeet.Chat repository on GitHub. Clone the forked repository to your local dev box using this command:

   git clone https://github.com/<your-username>/QuickMeet.Chat.git

2. Navigate into the project directory and configure a remote to connect your local copy and the original QuickMeet.Chat repository. This allows you to easily pull updates and bug fixes from the main project without needing to clone it again.

   cd QuickMeet.Chat
   git remote add upstream https://github.com/QuickMeet.Chat/QuickMeet.Chat.git

3. Confirm the Node.js version required by your QuickMeet.Chat version by executing the following command:

   cat package.json | grep -A4 engines | grep node

4. Install the required version of NodeJS replacing x.x.x with the required NodeJs version number:

   nvm install x.x.x

5. Install Deno by running:

   curl -fsSL https://deno.land/install.sh | sh

6. Initialize the meteor framework. This will show the version of meteor requested by QuickMeet.Chat (located in apps/meteor/.meteor/release). It will also initialize the framework.

   cd apps/meteor
   meteor --version
   cd ../..

6. Install all needed packages and proceed to build the QuickMeet.Chat app with these commands:

   yarn
   yarn build

7. Start your development server.

   For systems with 16 GB of memory or higher, use this command:

   yarn dev

   For systems with less than 16 GB of memory, use:

   yarn dsv

   Once it is finished, check your terminal for a message confirming the successful deployment. The local server will now be running on http://localhost:3000.

If you encounter any issues, see troubleshooting.

Set up a QuickMeet.Chat development environment on Non-Apple Silicon chips

This setup instruction has been tested on MacBook Pro 2015, 8Gig Ram, 512Gb SSD,i5.

1. Meteor comes pre-installed with npm and node. Confirm the versions by executing this command:

   meteor node -v
   meteor npm -v

2. Install Yarn if it's not already on your system. It is the recommended package manager.

   npm install --global yarn

Information on the various versions of packages needed can be found in the package.json

4. To easily manage the node versions on your machine, install the n node package manager and switch to your desired NodeJs version.

   npm install -g n
   n x.x.x
   node -v

Replace x.x.x with the NodeJs version number.

5. Fork the QuickMeet.Chat repository on GitHub. Clone the forked repository and navigate to the project directory using this command:

   git clone https://github.com/your-username/QuickMeet.Chat
   cd QuickMeet.Chat

6. Run the following commands to navigate to the meteor directory and download the necessary meteor version for QuickMeet.Chat, as configured in .meteor/release file:

   cd apps/meteor
   meteor --version

7. Navigate to the project root directory and install all the needed packages by executing this command:

   cd ../..
   yarn

8. Build and startup your development server by running this command:

   yarn build
   yarn dev

   Once it is finished, check your terminal for a message confirming the successful deployment. The local server will now be running on http://localhost:3000.

Modify the code in your IDE to see the changes on the server instance. You can now start contributing to QuickMeet.Chat. Check out the contribution guide to learn more about the contribution process.

Troubleshooting

sudo chown -R $(whoami) ~/.yarn
sudo chmod -R u+w ~/.yarn

➤ YN0007: │ fibers@npm:5.0.3 must be built because it never has been before or the last one failed
➤ YN0009: │ fibers@npm:5.0.3 couldn't be built successfully (exit code 1, logs can be found here: /private/var/folders/…/build.log)
➤ YN0009: │ fibers@npm:5.0.3 couldn't be built successfully (exit code 1, logs can be found here: /private/var/folders/…/build.log)
➤ YN0009: │ fibers@npm:5.0.3 couldn't be built successfully (exit code 1, logs can be found here: /private/var/folders/…/build.log)

(mach-o file, but is an incompatible architecture (have 'x86_64', need 'arm64e')), '/usr/local/lib/bcrypt_lib.node' (no such file), '/usr/lib/bcrypt_lib.node' (no such file)