💬 Join the community on Slack. The link can be found in the Talawa README.md file.

Talawa is a modular open source project to manage group activities of both non-profit organizations and businesses.

Core features include:

1. Membership management
2. Groups management
3. Event registrations
4. Recurring meetings
5. Facilities registrations

talawa is based on the original quito code created by the [Palisadoes Foundation][pfd] as part of its annual Calico Challenge program. Calico provides paid summer internships for Jamaican university students to work on selected open source projects. They are mentored by software professionals and receive stipends based on the completion of predefined milestones. Calico was started in 2015. Visit The Palisadoes Foundation's website for more details on its origin and activities.

talawa has these major software components:

1. talawa: A mobile application with social media features
2. talawa-api: An API providing access to user data and features
3. talawa-admin: A web based administrative portal
4. talawa-docs: The online documentation website

• The talawa documentation can be found here.
• Want to contribute? Look at CONTRIBUTING.md to get started.
• Visit the Talawa-Docs GitHub Repository to see the code.

The contents of the talawa-docs repo is used to automatically create the talawa documentation website. The automation uses Docusaurus, a modern static website generator.

For the installation, use only the yarn package as npm will throw an error. Only npm use case would be to install the yarn package. Visit the Docusaurus installation web page if you have any difficulties with the steps below.

The steps are simple:

1. Clone this repository
2. Install Yarn on your system using the instructions given below
3. If you have previously installed yarn on your local device run the following command to confirm

$ yarn -version

4. Follow these steps next

Note: Please bear in mind that to install docusaurus your system, a Node.js version 16.14 or above (which can be checked by running node -v) is required. Other requirements that pertains to the installation of docusaurus can be found here

$ git clone https://github.com/PalisadoesFoundation/talawa-docs
$ cd talawa-docs
$ yarn add docusaurus

NPM (Node Package Manager) is a package manager included with the Node.js installation. It is used for developing and sharing JavaScript code, but it also provides another method of installing Yarn

1. Download the Node Windows installer
2. After choosing the path, double-click to install. Then give access to run the application
3. Install Yarn by running the following command

$ npm install --global yarn

4. Check Yarn installation

$ yarn -version

Here’s how to install the Yarn package manager on Windows

1. Download the Yarn Windows installer

2. After choosing the path, double-click to install. Then give access to run the application

3. Check Yarn installation

$ yarn -version

The .pkg installer can be used to install Yarn on macOS. Using the .pkg installer also helps resolve dependencies since it does not require a command line to install Node.js

1. Click on the macOS Installer option to download the .pkg installer
2. Run the Node.js installer
3. Verify Node.js Installation by running the following command in your terminal

$ node -v
$ npm -v

4. Run the following command to install Yarn

$ sudo npm install --global yarn

5. Verify Yarn Installation

$ yarn --version

One of the easiest way to install Yarn on macOS is to use the command line installer

1. Install Yarn by running the given command in your terminal

$ brew install yarn

Installing Yarn on Linux through NPM can be done via command line installer, this doesn't automatically install Node.js

1. Run the following command in your terminal to install Node and NPM respectively. Confirm your Linux distro and it's command prompt

$ sudo apt install nodejs
$ sudo apt install npm

2. Verify installation

$ node -v
$ npm -v

3. Install Yarn with the following command

npm install --global yarn

To preview your changes as you edit the files, you can run a local development server that will serve your website and it will reflect the latest changes.

Follow these steps:

Note: Install the latest stable version of Node.js on your system if you get a The engine "node" is incompatible with this module. Expected version message during the procedure below. You may need to use a custom repository for this.

• Please bear in mind that to install docusaurus your system, a Node.js version 16.14 or above (which can be checked by running node -v) is required. Other requirements that pertains to the installation of docusaurus can be found here

$ sudo apt-get -y install npm
$ sudo npm install --global yarn
$ cd talawa-docs
$ yarn add docusaurus
$ yarn run start
OR
$ yarn run

By default, a browser window will open at http://localhost:3000.

This command starts a local development server and open up a browser window. Most changes are reflected live without having to restart the server.

In most cases is unnecessary. Running the development server will be sufficient.

If you need to generate static HTML pages (unlikely), then follow these steps.

$ yarn run build

This command generates static content into the /build directory and can be served using any static contents hosting service.