Skip to content

fiterace/slamapp

Repository files navigation

SlamApp

What is SlamApp ?

SlamApp, the online version of slam book allows final year students to carry memoirs of their stay in IIT Mandi. An app where seniors will have slams and everyone else (juniors/batchmates) can fill them out.

letter page

fill slams page

letter page

letter page

How to deploy ?

$ # Get the code
$ git clone https://github.com/fiterace/slamapp.git
$ cd slamapp
$
$ # Virtualenv modules installation (Unix based systems)
$ virtualenv env
$ source env/bin/activate
$
$ # Virtualenv modules installation (Windows based systems)
$ # virtualenv env
$ # .\env\Scripts\activate
$
$ # Install modules
$ # SQLIte version
$ pip3 install -r requirements.txt
$
$ # Create tables
$ python manage.py makemigrations
$ python manage.py migrate
$
$ # Start the application (development mode)
$ python manage.py runserver # default port 8000
$
$ # Start the app - custom port
$ # python manage.py runserver 0.0.0.0:<your_port>
$
$ # Access the web app in browser: http://127.0.0.1:8000

Note : For login you have to add google oauth credentials. Visit the Google API Console to obtain OAuth 2.0 credentials - client ID and client secret and configure them in admin page as explained in this tutorial. For more info on what else you can do with django-allauth library you can visit https://django-allauth.readthedocs.io/

How to Contribute ?

  1. Fork this repository to your github account.
  2. Clone the forked repository.
    git clone https://github.com/fiterace/slamapp.git
  3. Create a new branch.
    git checkout -b NewBranchName
  4. Make your changes.
  5. Stage the changes.
    git add path/to/changed-files
  6. Commit your changes.
    git commit -m "Appropriate Commit Message"
  7. Push your Changes
    git push origin NewBranchName
  8. Create a Pull request
  9. Mention someone to review it.
  10. Celebrate your Contribution 🚀

What's next ?

  • Basic Slam Book app
  • Add custom slambook creation Create Slam feature
  • Add notification feature - 1.) show number of unread slams with bell (notification) icon. 2.) send a reminder mail of newly received slams after every fixed interval (say 1 week)
  • Add invite link sending feature
  • Add Memories (image/video file) uploading feature
  • Add Slam Book Download feature ( A soft copy of Slams will be available for download after slambook filling period.)
  • Add Drop in Graffiti feature (Feel like dropping a few words about someone? Drop in a GRAFFITI.)
  • Social Profile feature (User profiles can be filled, updated and browsed)
  • Public/Private option in profile (An option in 'Edit Profile' to make SLAMBOOK public or private according to your convenience. The default setting will be 'Public'.)
  • Public Wall - where anyone can share anything - be it story, photo or short kissa - on that wall for anyone in passing batch (batchmates can do it too...). There can be permission feature in which one can give permission to others to post about him on wall and delete if someones posts something he/she dosen't likes.