bogas04 / SikhJS

👳 🚀 Gurbani Progressive Web Application

NOT MAINTAINED.

PLEASE USE/CONTRIBUTE TO SIKHITOTHEMAX INSTEAD.

SikhJS

SikhJS aims to be a Progressive Web App because we feel just like one slowly progresses in Sikhi by reading baani little by little, so should the storage of an application increase, while giving consistent experience everywhere.

NOTE: The application is still in active development and is not fit for public release just yet.

Why ?

Well I'm a Sikh and I happen to be a web developer, so I saw an opportunity to use my skills to serve to my fellow Sikh brothers and sisters. Apart from that, the main reason behind the project is that the Baani softwares are of 1990s era in 2010s. They are in dire need of a revamp, and this I believe is the first step towards a modernization of Baani on web.

Common Issues with current Sikh Apps	How web solves it
Usually only available on one platform.	Web on other hand, works everywhere.
Feature parity between platforms is bad.	Web is consistent throughout platforms.
Sharing baani needs you to use share features within the app or go back to screenshots!	It's still a URL in web, you can share or copy or print it easily!
You can't bookmark something on your phone app and later use it on desktop app. This sort of ecosystem is not really present in popular Sikh apps.	Once again, web with help of synced databases can help you acheive this very easily.

More importantly, this project is MIT license, which anyone can contribute to or even fork into a separate project. This way whatever innovation and problems we solve or create, will become a lesson for the future software teams.

And the project is totally free. No ads, no operating costs (it's a web app hosted on gh-pages).

Contribute

You can contribute by

• Reporting Issues.
• Becoming a code-collaborator.
• Becoming a content-collaborator.
  • Contribute to Raags and Authors descriptions. Add images, links, more text etc to the markdown files.
  • Contribute to beautification/correction(if any) of Nitnem baanies. These are simple markdown files that can take help of formatting of text.

Build

The project uses React, ES2015+, hence a bundler + transpiler is used in the build process.

Instructions

# Installation
git clone https://github.com/bogas04/SikhJS.git
cd SikhJS
npm i

# Run development server
npm start

# Build bundle
npm run build

Progress

Plans & Changelog

Bugs

Credits

Thanks to

• Guru Sahib for giving me talent and skill.
• Khalis Foundation for their Khajana API.
• GurbaniNow.
• Sikher.com for SGGS api.sikher.com.
• Documents from:
  • SikhNet for the actual Baanies.
  • GurbaniFiles.org.
  • SearchGurbani.com.
• and everyone else who is making this possible.

License

MIT