Skip to content

deleusec/spheriim-frontend

Repository files navigation

Spheriim

GitHub last commit GitHub issues

GitHub Repo stars License: MIT GitHub code size in bytes GitHub top language

1. Description

Spheriim logo

This project aims to create a website for students and their teachers. Each student has a profile with important information relating to the course.

2. Screenshot

Spheriim

3. Diagram and architecture

3.1 Diagram

Spheriim diagram

3.1.1 Diagram explaination

  • User: The user is the person who uses the application.
  • Supabase: The database used to store the user's data.
  • AgGrid: The table used to display the user's data.
  • React: The framework used to build the application.
  • Tailwind: The CSS framework used to style the application.

3.2 Architecture

  • assets: Static files like images, fonts, and other media.
  • components: Reusable UI components.
  • app: Folder for the main application layout and routing.

4. Requirements

5. How to Install

5.1 Clone the Repository

git clone git@github.com:deleusec/spheriim-frontend.git

5.2 Install Dependencies

cd spheriim-frontend
pnpm install

5.3 Run the Project

pnpm run dev # Navigate to localhost:3000

6. Tests

pnpm test

7. Stack

7.1 Script & Logic

7.2 JS Framework

7.3 Style

7.4 DB

7.5 Tools

7.6 Test

7.7 Lint and Format

7.8 Useful

  • πŸ“ˆ AgGrid: The best JavaScript Data Table for building enterprise web apps.
  • πŸ“Š Chart.js: Simple yet flexible JavaScript charting for designers & developers.

πŸ” Back to the top

This concise structure ensures clarity in describing the technology stack within the specified constraint.

8 How to Contribute

8.1 Thanks

Thank you for considering contributing to the project! Whether it's a bug report, new feature, code review, or feedback, your help is appreciated. By participating, you are expected to uphold the project's Code of Conduct. This document provides guidelines for respectful, inclusive, and productive participation in the project. Please report any unacceptable behavior to the project's maintainers.

8.2. Review the Contributing Guidelines

Before contributing to the project, please review the project's Contributing Guidelines. This document provides guidelines for contributing to the project and participating in the community. By participating, you are expected to uphold these guidelines. If you have any questions about the guidelines, please reach out to the project maintainers.

8.3. Explore Open Issues

If you're unsure where to start, consider exploring the project's open issues. This is a great way to find a specific task to work on. If you find an issue that interests you, leave a comment to let others know you're working on it. If you don't find an issue that interests you, consider opening a new issue to propose a new feature or report a bug.

8.4. Submit an Issue

If you encounter a problem or have an idea for a feature, submit an issue to the project's repository. This allows the maintainers and other contributors to discuss the matter and provide feedback. When submitting an issue, please follow the provided template and provide as much detail as possible.

8.5 Make a Pull Request

Once you've made your changes, submit a pull request to the project's repository. Your pull request will be reviewed by the maintainers, and any necessary adjustments will be requested. Once your pull request is approved, it will be merged into the project.

8.5.1 Here's how to submit a pull request:

  1. Fork the repository: Click the "Fork" button in the upper right corner of the repository's page.
  2. Clone the repository: Clone the forked repository to your local machine.
  3. Create a new branch: Create a new branch for your changes.
  4. Make your changes: Make your desired changes to the project.
  5. Commit your changes: Commit your changes to the new branch.
  6. Push your changes: Push the new branch to your forked repository.
  7. Submit a pull request: Submit a pull request to the project's repository.
  8. Review and address feedback: The project maintainers will review your pull request and provide feedback. Be ready to make any necessary adjustments.

8.6. Await Feedback

After submitting your pull request, the project maintainers will review your changes and provide feedback. Please be patient and be prepared to make any necessary adjustments. Once your pull request is approved, it will be merged into the project.

9. Code of Conduct

We expect contributors to adhere to the project's Code of Conduct. This document provides guidelines for respectful, inclusive, and productive participation in the project. By participating, you are expected to uphold this code of conduct. Please report any unacceptable behavior to the project's maintainers.