Skip to content

shulutions/Shulutions-Open-Source

Repository files navigation

Shulutions Open Source

Shulutions Open Source is a full-stack web application built using Angular and NestJS. The purpose of this application is to provide a platform for users to share, discuss, and manage open-source projects efficiently.

This README.md file contains the necessary information for setting up and running the Shulutions Open Source application on your local machine.

User Types and Features

Shulutions Open Source supports 4 types of users, each with specific features and capabilities:

Non-user

  • View project ideas and comments
  • View information about the current open-source projects
  • Join the sub-community of the open-source projects they are interested in
  • Register for an account

Registered user

  • Login to their account
  • Post new project ideas
  • Vote for their favorite project ideas
  • Comment on project ideas
  • Update profile details

Project Manager

  • Update the details of the projects they are managing

Admin

  • View and update all projects on the system
  • View and delete project ideas
  • Manage the projects that are displayed on the website

Prerequisites

Before you begin, ensure you have the following installed on your local machine:

  • Node.js
  • npm
  • Angular CLI
  • NestJS CLI

Getting Started

  1. Clone the repository:
git clone https://github.com/yourusername/shulutions.git
cd shulutions
  1. Install the dependencies for both the frontend and backend:
cd frontend
npm install
cd ../backend
npm install
  1. Configure the environment variables:

Create a .env file in the /backend directory and configure the necessary environment variables (e.g., database credentials, JWT secret, etc.).

  1. Start the NestJS backend:
cd backend
npm run start:dev

The backend server should now be running on http://localhost:3000.

  1. Start the Angular frontend:
cd ../frontend
ng serve

The frontend application should now be running on http://localhost:4200.

Support

If you encounter any issues or have any questions about the project, please create an issue or contact the project maintainers.

Happy coding!

About

An online community for the SHU Software Engineering Society

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •