Skip to content

lazycipher/social-platform-donut-frontend

 
 

Repository files navigation

DONUT

codeuino's open source social platform

Slack Status PRs Welcome Issues Open License: GPL v3

For frontend of this repo move to this repository.

What is Donut?

Being inspired by the Cornucopia of various social hub this project has been developed taking into consideration about open source.

Well, this is an Open Source Social networking hub which acts as a bridge between various Developers, Organisations and Open Source aspirants to elaborate on various things like #Projects, #Events, #Discussion on various researches, #Scholarships, #Coding release and various other things updates.

The major priority of this project has been that this platform allows users to make their project "Open Sourced" and released them under various open source Organisations, experts which hold up a ring plate on this portal.

This platform also makes users introduce and develops various solutions in the form of FOSS software to publish them for public use by integrating them with their social cause. Moreover, this project can be downloaded by any user, organization and can be used by them in their own custom way, making it run on their servers. It is built on Node.js and utilizing mongoose as a database.

Technical Features

  • Sign Up / Login Authentication
  • Node.js basic Password Authentication ( Uses Unique email and Password )
  • Third party access login
  • Sign Up as a User and Organisation
  • Write any Post that acts as a Feed ( with various formatting tools, tags effect, etc )
  • Propose any project that a person wants to raise as researched under various organizations and experts.
  • Write Events and get updates of various Events happening around.
  • Scholarship Raiser, Open Source Internships.
  • Open up the environment for the discussion through integrated Discussion platform
  • Act with Open Stat
  • Appropriate Dashboard with most APIs Activities log of projects and other things.
  • Sourced Packaged, Custom made software ( can be changed according to needs after downloading it.
  • Provides various opportunities to integrate many other Open Source projects recognized by organizations

Installation

NODE JS NPM

To get this project running locally on your machine follows the steps below in order:

  1. fork this repo

  2. clone the forked repo from your GitHub using the command git clone https://github.com/username/Social-Platform-Donut.git don't forget to replace the username in the URL

    fork-and-clone

  3. Checkout to the development branch

        git checkout development
  4. Setting up the project locally.

    npm install
    or 
    yarn global add
  5. Setting up the local database instance

    You need to have a MongoDB atlas account to create local database. Check out this link to setup MongoDB atlas. The mongodb URL should be pasted in credential.js files.

  6. run this command to run on local

    nodemon server.js

    or

    node server.js

HURRAY! you have done it just start contributing to the project.

Now open your browser and type the link http://localhost:3000 to continue viewing project.

Adding yarn support for the packages just type yarnin the cli and hit enter.

Setting Up Database

MongoDB

Make sure you have MongoDB installed on your computer. If not get it here MongoDB Community Server

  1. Open the terminal, locate the "scripts" folder and run the dbcreater.sh

    bash dbcreater.sh

Note: For windows user, run this command using git bash

Contributions Best Practices

GitHub issues GitHub pull requests GitHub contributors

Commits

  • Write clear meaningful git commit messages (Do read this).
  • Make sure your PR's description contains GitHub's special keyword references that automatically close the related issue when the PR is merged. (Check this for more info)
  • When you make very very minor changes to a PR of yours (like for example fixing a failing Travis build or some small style corrections or minor changes requested by reviewers) make sure you squash your commits afterward so that you don't have an absurd number of commits for a very small fix. (Learn how to squash at here)
  • When you're submitting a PR for a UI-related issue, it would be really awesome if you add a screenshot of your change or a link to a deployment where it can be tested out along with your PR. It makes it very easy for the reviewers and you'll also get reviews quicker.

Community

GitHub forks GitHub stars GitHub last commit

All feedback and suggestions are welcome!

Sponsors/Partners

Support this project by becoming a sponsor/collaborator/partner/contributors. [Become a sponsor]

Current

Licensing

GitHub license

Donut An Open Source Social Collaborating platform is a web Based framework Software,

Copyright (C) < 2018 Codeuino Contributors > This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License V3 as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details at OSI https://opensource.org/licenses/GPL-3.0

You should have received a copy of the GNU General Public License along with this program. If not, see this.

Twitter Follow Open Source Love

About

This is an Open Source social Platform where people can interact with Open Source expertise around the globe and work on different projects

Resources

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 76.8%
  • SCSS 19.0%
  • CSS 3.9%
  • Other 0.3%