|
1 | | -barebones setup for JavaScript / Node projects replace this with a one-liner phrase describing this project or app |
| 1 | +trainings, certifications and employment opportunities for teachers |
2 | 2 |
|
| 3 | +[](https://app.codacy.com/gh/BuildForSDG/EduKolab-Frontend?utm_source=github.com&utm_medium=referral&utm_content=BuildForSDG/EduKolab-Frontend&utm_campaign=Badge_Grade_Settings) |
3 | 4 | [](https://app.codacy.com/gh/BuildForSDG/team-099-frontend?utm_source=github.com&utm_medium=referral&utm_content=BuildForSDG/team-099-frontend&utm_campaign=Badge_Grade_Settings) |
4 | | -[](https://img.shields.io/badge/Code%20Quality-D-red) |
5 | | - |
6 | 5 |
|
7 | 6 | ## About |
8 | | - |
9 | | -What is this project about. Ok to enrich here or the section above it with an image. |
10 | | - |
11 | | -Once this repo has been setup on Codacy by the TTL, replace the above badge with the actual one from the Codacy dashboard, and add the code coverage badge as well. This is mandatory |
12 | | - |
13 | | -This is a simple JavaScript starter repo template for setting up your project. The setup contains |
14 | | - |
15 | | -- Jest: For runnung tests. We strongly recommend that JavaScript projects use Jest |
16 | | - |
17 | | -- Eslint & Prettier: For formatting code to match ESlint AirBnB coding standard. You might need to install the ESlint and Prettier plugins for your code editor to make the most of these utilities |
| 7 | +The name of our soolution is **EduKolab**. |
| 8 | +It is a web app that: |
| 9 | +- connects teachers in primary && secondary schools with international cooperations for training and certification as well as |
| 10 | +- offers trained & certified teachers to schools && guardians for employment |
18 | 11 |
|
19 | 12 | ## Why |
| 13 | +The problem we set out to solve is that of |
| 14 | +_**insuuficient supply of qualified teachers in your community, Nigeria, as well as other developing countries**_. |
20 | 15 |
|
21 | | -Talk about what problem this solves, what SDG(s) and SGD targets it addresses and why these are imoirtant |
| 16 | +This project is geared at addressing the [4th Sustainable Developemnt Goal of Education](https://sustainabledevelopment.un.org/sdg4) |
22 | 17 |
|
23 | | -## Usage |
24 | | - How would someone use what you have built, include URLs to the deployed app, service e.t.c when you have it setup |
| 18 | +EduKolab aims particularly to improve the quality of education provided to primary && secondary school students by improving the quality of the teachers, the people who pass on this knowledge. |
| 19 | +It is very important and relevant especially in this time for a good number of reasons notable among which are: |
| 20 | +- We will help create job employments for teachers that have been laid off because of the economic crises resulting from the Covid-19 pandemic |
| 21 | +- We will improve the quality of education in the country and hopefully Africa by improving the quality of knowledge && teaching methods employed by teachers to pass on knowledge |
25 | 22 |
|
| 23 | +## Usage |
| 24 | +URL to deployed staging-app is below |
| 25 | +[EduKolab Staging App](https://edukolab-staging-app.herokuapp.com/) |
26 | 26 |
|
27 | 27 | ## Setup |
28 | | - |
29 | | -Install `npm` or `yarn` if you dont have any of them already installed. We recommend Yarn though. |
30 | | - |
31 | | -After clonning the repo to your local machine and moving into the cloned folder, Run `yarn install` to get started by installing dependencies. |
32 | | - |
33 | | -`src/index.js` is the entry to the project and source code should go into the `src` folder. |
34 | | - |
35 | | -All tests should be written in the `__tests__' folder. There's a sample in there. |
36 | | - |
37 | | -This starter uses [Parcel](https://parceljs.org/getting_started.html) as the bundler. It is much simpler that WebPack and the others |
| 28 | +1. Clone repo `git clone https://github.com/BuildForSDG/EduKolab-Frontend.git edukolab` |
| 29 | +2. Verify npm global installation by running `npm install npm -g` |
| 30 | +3. Install dependencies by running `npm install` from the **edukolab** directory/folder |
| 31 | +3. Start app locally by running `npm run dev` from the **edukolab** directory/folder |
38 | 32 |
|
39 | 33 | #### Hints |
40 | | - |
41 | | -- Run `npm install` or `yarn install` to get started. We'll assume you are using Yarn. |
42 | | -- Install additional dependencies: `yarn add <dependency-name> [-D]` |
43 | | -- Run tests: `yarn test` |
44 | | -- Run tests with test coverage info: `yarn test:cover` |
45 | | -- Check the codebase for proper syntax and formatting compliance: `yarn lint` |
46 | | -- Run your app in local dev mode: `yarn start`. This puts the bundled app in a `dist` folder, set up a local web server at localhost:1234, and continues to watch for your code changes which it syncs with the local server. This means if you loaded the app in a browser, it will auto-refresh as you code along. Feel free to use whatever bundler best meets your needs. Parcel was only added as a sample and for those looking for a simple but effective solution to the hassle of bundlers. |
| 34 | +1. Get Started: `npm install` |
| 35 | +2. Install additional dependencies: `npm install <dependency-name>` |
| 36 | +3. Run tests: `npm run test` |
| 37 | +4. Run tests in watch mode: `npm run test:watch` |
| 38 | +5. Run tests with test coverage info: `npm run test:cover` |
| 39 | +6. Check the codebase for proper syntax and formatting compliance: `npm run lint` |
| 40 | +7. Check the codebase for lint and test errors: `npm run check` |
| 41 | +8. Build app for deployment: `npm run build` |
| 42 | +9. Run app from build: `npm start` |
| 43 | +10. Run app in local dev mode: `npm run dev`. |
| 44 | +- This first runs `npm run check` to check codebase for lint and test errors. If any are found, an npm error is thrown and the app exits with an error code |
47 | 45 |
|
48 | 46 | ## Authors |
49 | 47 |
|
50 | | -List the team behind this project. Their names linked to their Github, LinkedIn, or Twitter accounts should siffice. Ok to signify the role they play in the project, including the TTL and mentor |
| 48 | + Sam Karis -- Team Mentor -- @sam-karis |
| 49 | + Jedidiah Amaraegbu -- Technical Team Lead -- @amjedidiah |
| 50 | + Victor Nwoguru -- Technical Communication Lead -- @vkguru |
| 51 | + Philip Okonwanji -- @okonwanjiphilip |
| 52 | + Hussein AbdulAzeez -- @lahkanmi |
| 53 | + Yusuf AbdulAzeez -- @horler408 |
51 | 54 |
|
52 | 55 | ## Contributing |
53 | 56 | If this project sounds interesting to you and you'd like to contribute, thank you! |
54 | | -First, you can send a mail to [email protected] to indicate your interest, why you'd like to support and what forms of support you can bring to the table, but here are areas we think we'd need the most help in this project : |
| 57 | +First, you can send a mail to [email protected] copy [email protected] to indicate your interest, why you'd like to support and what forms of support you can bring to the table, but here are areas we think we'd need the most help in this project : |
55 | 58 | 1. area one (e.g this app is about human trafficking and you need feedback on your roadmap and feature list from the private sector / NGOs) |
56 | 59 | 2. area two (e.g you want people to opt-in and try using your staging app at staging.project-name.com and report any bugs via a form) |
57 | 60 | 3. area three (e.g here is the zoom link to our end-of sprint webinar, join and provide feedback as a stakeholder if you can) |
58 | 61 |
|
59 | 62 | ## Acknowledgements |
60 | 63 |
|
61 | | -Did you use someone else’s code? |
62 | | -Do you want to thank someone explicitly? |
63 | | -Did someone’s blog post spark off a wonderful idea or give you a solution to nagging problem? |
64 | | - |
65 | | -It's powerful to always give credit. |
66 | | - |
67 | 64 | ## LICENSE |
68 | 65 | MIT |
69 | | - |
0 commit comments