https://github.com/jordanopensource/contributions-api
API for JOSA Contributions
https://github.com/jordanopensource/contributions-api
Last synced: about 1 year ago
JSON representation
API for JOSA Contributions
- Host: GitHub
- URL: https://github.com/jordanopensource/contributions-api
- Owner: jordanopensource
- Created: 2021-10-25T11:26:34.000Z (over 4 years ago)
- Default Branch: development
- Last Pushed: 2025-03-23T08:04:45.000Z (about 1 year ago)
- Last Synced: 2025-04-12T17:12:17.017Z (about 1 year ago)
- Language: JavaScript
- Homepage:
- Size: 253 KB
- Stars: 3
- Watchers: 8
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
contributions-api
The Api client for the Jordan Top Contributors website.
Explore the docs »
·
Report Bug
·
Request Feature
[](https://builds.josa.ngo/jordanopensource/contributions-api)
Table of Contents
## About The Project
This is a Express api client for the Jordan Top Contributors Website, a website that displays the top contributors to open source repositories in Jordan.
### Built With
- [Express](https://expressjs.com/)
- [MongoDB](https://www.mongodb.com/)
## Getting Started
To get a local copy up and running follow these simple steps.
### Prerequisites
1. Download and install the latest version of Node.js from [here](https://nodejs.org/en/download/).
### Installation
1. Clone the repo
```sh
git clone https://github.com/jordanopensource/contributions-api.git
```
2. Install NPM packages
```sh
npm install
```
### Running
#### Development
To run the project locally for development purposes:
1. Copy the env file and change the values inside
```sh
$ cp .env.sample config.env
```
2. Run the project
```sh
$ npm run dev
```
2. Go to `http://localhost:3000`
#### Production
To build and run the project locally for production purposes:
1. Launch the production server
```sh
$ npm run start
```
## Roadmap
See the [open issues](https://github.com/jordanopensource/contributions-api/issues) for a list of proposed features (and known issues).
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## License
Distributed under the Apache License. See `LICENSE` for more information.
## Contact
Jordan Open Source Association - [@jo_osa](https://twitter.com/@jo_osa) - info@josa.ngo
Project Link: [https://github.com/jordanopensource/contributions-api](https://github.com/jordanopensource/contributions-api)