Welcome to Rebuild Black Business 👋

The website for https://www.rebuildblackbusiness.com/

🏠 Homepage

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

How can I get involved now?

The first step is to make sure that you're a part of the Discord Community. State in the #sorting-hat channel your desire to join the Developer team. This will get you access to the development channels for further information.

We're tracking all high level Web Development tasks in Trello:

If you see a task in the Trello that seems like something you'd like to tackle, comment on the task expressing your interest. A project manager will assign the task to you. Tasks are then elaborated on in detail within GitHub Issues. The Trello card will have a link to the corresponding issue so you can get started!

Branch Name Conventions

When contributing, please fork this repository by clicking the “fork” button at the top right. This creates your own copy of the repository where you’re able to make changes. Once you have forked the repository, please structure your branches using the following format.

feature/task-description - Feature branches are for all new feature work. The task description should be descriptive enough to quickly understand the work done in this branch. Please keep your features concise and ensure the work done in this branch directly relates to your task.

fix/task-description - Fix branches should be leveraged for bug fixes on existing features

hotfix/task-description - Hotfix branches should only ever be leveraged for critical bug fixes that need attention immediately. This would only be use if there is a broken feature or bug on production that needs to be addressed urgently.

Pull Requests

To send your changes for review, open a pull request. If you’ve never opened a pull request before, read Thanoshan’s article on creating a pull request for more information!

Once you've created your pull request, please assign the following folks as reviewers:

@magnificode
@domitriusclark
@racedale

Terminology

User Types - Dynamic user data for the various types of data used on the site. Currently this includes the following
- Business In Need
- Black Owned Business
- Service Organization
- Ally

🖥️ Tech Details

Frontend

The website is built using Gatsby, with UI components leveraging Chakra UI with custom theming for rapid and consistent component driven development.

Data

Data for the various user types is stored in Airtable. Each user type has it's own table that the site pulls from and displays.

To get access to this data, please join the Rebuild Black Business Discord and express your interest in helping to your assigned Team Lead. They'll get you read access to the data in a timely manner.

Install

Clone the repository

First, fork this repository by clicking the “fork” button at the top right. This creates your own copy of the repository where you’re able to make changes.

Second, clone your copy of the repo to your local machine:

# clone the repo
git clone git@github.com:YOUR_USERNAME_HERE/RBB-Website.git
# move into the new folder
cd RBB-Website/
# install dependencies
npm install

Add environment variables

This site uses Airtable to keep track of business data. You’ll need an Airtable API key get access to the base we’re using here. To get access, please reach out to your Team Lead in Discord.

Once you've obtained access, go to the API docs and grab your API key: https://airtable.com/appFoFzjMcciPUgoK/api/docs#javascript/authentication

Check the “show API key” box at the top-right, then look for yours in the code sample displayed next to the “Authentication” docs.

Once you have your API key, create a file called .env and add your API key:

AIRTABLE_API_KEY=YOUR_API_KEY

NOTE: See .env.EXAMPLE for a copy-pasteable template to get set up!

Usage

Now that you’ve got the files and an API key, you can start the site on your machine!

npm run develop

This will start Gatsby and show you a local development URL. Whenever you make code changes, Gatsby will automatically reload the browser to show you your changes.

To stop the development server, press control + C in your terminal.

Run tests

npm run test

Author

👤 Rebuild Black Business

Github: @Rebuild-Black-Business

Yeg-A / RBB-Website