Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/el634dev/zensphere

Supportive chatroom to help improve mental health
https://github.com/el634dev/zensphere

Last synced: about 1 month ago
JSON representation

Supportive chatroom to help improve mental health

Awesome Lists containing this project

README

        

# ZenSphere
> Supportive chatroom that is geared towards creating supportive communities to improve mental health.
>
[![made-with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg)](https://www.python.org/)
[![Documentation Status](https://readthedocs.org/projects/ansicolortags/badge/?version=latest)](http://ansicolortags.readthedocs.io/?badge=latest)

# Quickstart/Demo
> Live demo [_here_](https://www.example.com).

## Table of Contents
* [Technologies Used](#technologies-used)
* [Features](#features)
* [Usage](#usage)
* [Project Status](#project-status)
* [Room for Improvement](#room-for-improvement)
* [Acknowledgements](#acknowledgements)
* [Installation](#installation)
* [License](#license)

## Technologies Used
[![Front-End](https://skillicons.dev/icons?i=html,css,bootstrap)](https://skillicons.dev)
[![Back-End](https://skillicons.dev/icons?i=flask,py)](https://skillicons.dev)
![Socket.io](https://img.shields.io/badge/Socket.io-black?style=for-the-badge&logo=socket.io&badgeColor=010101)
![SQLAlchemy](https://img.shields.io/badge/sqlalchemy-black?style=for-the-badge&logo=sqlalchemy&badgeColor=010101)

## Features
- Sign Up and Login Form
- Auth
- Multiple responsive web pages
- Chatroom

## Usage
`User is able to navigate to sign up form by clicking the Sign Up button.`
>
`User is able to navigate to login form by clicking the Login button.`
>
`User is able to see dashboard and then join or create a chatroom after login into the website.`
>
`User is able to have a real-time conversation while inside of the chatroom with another user(s).`

## Project Status
Project is: _completed_

## Room for Improvement
To do:
- User can add a picture to a profile
- User can see their profile picture in the chatroom

## Acknowledgements
- This project was inspired by a random thought
- Many thanks to my teachers

## Installation
See the appropriate guide for your environment and operating system.
- Flask or older Flask version
- Other frameworks that are not Flask, Bootstrap, Jinja2, SQLAlchemy
>
a. Flask Installation
>
Add Flask to your global or virutal enivorment:
For macOS:
`pip3 install flask`
For Windows:
`pip install flask`
- Make sure that Flask is the current version
- If using the virtual enivorment make sure to navigate to your folder that you create your env folder and activated your env
- You can activate your enivorment by typing `source/venv/bin/activate` and for Windows `.\env\Scripts\activate`
>
b. Boostrap Installation
> Add the link provided by Boostrap in your header located in your HTML file (this could also be your base file).
>
> ``
>
> Make sure to use version 5 as this is the latest version
>
c. Jinja/HTML/CSS Installation
> There is no installation needed for Jinja, HTML, CSS. When using Jinja just use {%%} to utilize Jinja.
> HTML and CSS is built into VSCode, while Jinja is Flask's official templating engine.

d. SQLAlchemy/Socket.io Installation
> Add the link provided by Socket.io in your head tag located in your HTML file (this could also be your base file).
>
> ``
>
> SQLAlchemy can be installed by using `pip3 install flask_sqlalchemy` or `pip install flask_sqlalchemy`

## License
- Licensed under Apache 2.0
[(Back to top)](#table-of-contents)