/quran.com-frontend

quran.com frontend

Primary LanguageTypeScriptGNU General Public License v3.0GPL-3.0

Quran.com CircleCI

This project is the frontend for Quran.com. It is built using Reactjs + Redux + Expressjs + Webpack. It is isomorphic (javascript shared between both the server and the client) for SEO reasons.

Code Climate

How to contribute

We trust that you will not copy this idea/project, this is at the end for the sake of Allah and we all have good intentions while working with this project. But we must stress that copying the code/project is unacceptable.

Read the contributing section before creating an issue.

Running the app locally

  • Ensure you have nodejs installed
  • Get the source by running git clone https://github.com/quran/quran.com-frontend/ or creating a fork
  • Run npm install to do first time installation of all dependencies
  • Run npm run dev to start the dev server.
  • Open http://localhost:8000 in your browser to see the app.

Staging

To see the app with the latest changes, see the staging site. Production releases are made periodically when staging is stable and well tested.

Backend

The API source is at https://github.com/quran/quran.com-api

DB is private. Message on Slack to requrest access.

The dev server uses the staging API by default. If you want to use a local API server, follow the instructions in the API repo and run the server locally then update the API_URL field in app.json to point to the local address.

Slack

Create an issue with your email for us to add you to the Slack group

Design

We currently use InvisionApp. Again, contact me if you'd like access to it.