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

https://github.com/egytech-fyi/egytech-fyi

The Frontend repo for egytech.fyi. egytech.fyi provides comprehensive data and statistics on participants in the tech industry. Easily retrieve information on job titles, experience levels, compensation, and more. Powered by Cloudflare Pages. πŸš€
https://github.com/egytech-fyi/egytech-fyi

cloudflare-pages dashboard egyptian-programmers highcharts react typescript vitejs

Last synced: 6 months ago
JSON representation

The Frontend repo for egytech.fyi. egytech.fyi provides comprehensive data and statistics on participants in the tech industry. Easily retrieve information on job titles, experience levels, compensation, and more. Powered by Cloudflare Pages. πŸš€

Awesome Lists containing this project

README

          

# 🌟 EGYTECH.FYI Frontend

Welcome to the frontend repository for egytech.fyi, a dynamic dashboard and reporting tool that provides insights into the Egyptian Tech Scene. This application visualizes salary data and industry trends, akin to the Stack Overflow Developer Survey, enabling users to filter and analyze compensation within the tech sector in Egypt.

## πŸ“‹ Table of Contents

- [🌟 EGYTECH.FYI Frontend](#-egytechfyi-frontend)
- [πŸ“‹ Table of Contents](#-table-of-contents)
- [πŸš€ Getting Started](#-getting-started)
- [πŸ”§ Prerequisites](#-prerequisites)
- [πŸ“¦ Installation](#-installation)
- [πŸ–₯️ Running the Application](#️-running-the-application)
- [πŸ” Running Lint](#-running-lint)
- [πŸ‘€ Previewing Build](#-previewing-build)
- [🎨 Features](#-features)
- [πŸ“š Folder Structure](#-folder-structure)
- [🀝 Contributing](#-contributing)
- [Contributors](#contributors)

## πŸš€ Getting Started

### πŸ”§ Prerequisites

Before you begin, ensure you have the following installed:

- [Node.js](https://nodejs.org/)
- [Yarn](https://yarnpkg.com/)

### πŸ“¦ Installation

To set up the project locally, follow these steps:

1. Clone the repository:

```bash
git clone https://github.com/your-username/egytech-fyi.git
cd egytech-fyi
```

2. Install dependencies:

```bash
yarn install
```

### πŸ–₯️ Running the Application

Start the development server:

```bash
yarn dev
```

This will launch the Vite development server, making the application accessible at `http://localhost:3000`.

### πŸ” Running Lint

To ensure code quality and consistency, run ESLint with:

```bash
yarn lint
```

For best development, use these VS Code extensions:

- EditorConfig
- ESLint
- Prettier - Code formatter

### πŸ‘€ Previewing Build

To build the project and preview it locally:

```bash
yarn run build
yarn preview
```

## 🎨 Features

This dashboard includes:

- Interactive filters to view data based on job titles, experience levels, and technology stacks.
- Visual representations of salary ranges and distributions.
- Comparisons and analytical reports similar to industry surveys.

## πŸ“š Folder Structure

```javascript
└── πŸ“egytech-fyi
└── πŸ“.github
└── PULL_REQUEST_TEMPLATE.md
└── πŸ“.husky
└── pre-commit
└── pre-push
└── .prettierrc
└── πŸ“.vscode
└── settings.json
└── πŸ“public
└── πŸ“src
└── πŸ“assets
└── πŸ“components // for all the components used
└── πŸ“Shared // for shared agnostic components
└── πŸ“constants // for constants used across the repo
└── πŸ“context // for state contexts
└── πŸ“functions // for general functions
└── πŸ“mock //for mock data
└── πŸ“pages // for pages
└── πŸ“services // for api services
└── πŸ“styles // for style files (should follow the convention of .styles.scss)
└── πŸ“types // type script types
└── πŸ“utils // for utility functions
└── πŸ“Transformers // for data transformation functions
└── App.tsx
└── index.css
└── main.tsx
└── vite-env.d.ts
└── README.md
└── CONTRIBUTING.md
└── index.html
└── package.json
└── tsconfig.json
└── tsconfig.node.json
└── vite.config.ts
```

## 🀝 Contributing

Contributions are welcome! To help make this project better, please see the [CONTRIBUTING.md](CONTRIBUTING.md) file.

### Contributors

This project exists thanks to all the people who contribute. A special thanks to our key contributors:

- **Abdelrahman Eladawy**

- **GitHub:** [MrViometal](https://github.com/MrViometal)
- **LinkedIn:** [Abdelrahman Eladawy](https://www.linkedin.com/in/abdelrahman-el-adawy/)

- **Ahmed Eladawy**

- **LinkedIn:** [Ahmed Eladawy](https://www.linkedin.com/in/ahmed-eladawy-00b4a3115/)

- **Mahmoud Salem**
- **GitHub:** [mahsayedsalem](https://github.com/mahsayedsalem)
- **LinkedIn:** [mahsayedsalem](https://www.linkedin.com/in/mahsayedsalem/)

---

Visit the live application: [egytech.fyi](https://egytech.fyi)