The challenge is meant to come up with a JKUAT AGGES website that will serve the club by bringing together the alumni, connecting students to potential companies and even current geospatial technologies.This will even alleviate the hustles the junior students need to go through to realise even the basic geospatial concepts.
- This challenge was officially launched on 7th October 2021 at JKUAT-AGGES Weekly meetup room, Hall 7 room 005.
- Evaluation dates and closure of the competition was 7th February 2022.
- The launch of the Version 1.0.0 of the AGGES website was Thursday 10th March 2022
- Visual Studio Code, Code editor -For writting and reading your code
- Git Bash - For controlling your project versions
- Git Hub - For hosting your project in developement and production mode
- Brave, Google Chrome, Mozilla Firefox - For testing and debugging your website code
Your submission will be reviewed by the committe heads. We'll take your experience level into consideration when reviewing.
We value quality over completeness. If you decide to leave things out, please call attention to it in your project's README file.
Our assessment covers the following areas:
- A correct fork, branch and pull request from the main branch.
- We will use github timestamp
- Architecture - How have you decided to structure your app? - Is there good separation of concerns or things/pages are cluttered?
- Code quality
- Are you following good coding practices?
- Is your code easy to follow and maintain?
- Is it testable?
- Is it transferable?
- Correctness
- Does your application work?
- Does it meet the functional spec?
- Technical choices
- Are your choices of libraries, packages, and tooling appropriate?
Bonus points:
- Testing - Is there adequate test coverage?
- UX - Is your project easy to use and understand?
- UI -Is the User interface attractive to the viewer?
With the asssumption that you are using frontend framework of your choice create a new JKUAT AGGES Club website that will serve the club.
- Kindly check out the following guidelines:
- You host the site on either heroku, netlify, github pages or the site of your choice.The proposed are free hosting services
- Perfomance and speed is essential
- The Website should be fully responsive
Home Section
- Make it look like a landing site and as attractive as you can
- Remove unnecessary clutter
- Add pictures for various GEGIS and Spatial related stuff.You can link up with Okomo on Twitter or WhatsApp to provide you with Images and other assests.
- Remove navigation bar above the footer
- Jkuat web map to have a search box for venues by building name or course.
About Section
- AGGES gallery to load efficiently
- A way of updating the gallery
- AGGES committee to be available.
- AGGES committee to have profile picture, current position, linkedin link and twitter link
Our Team
- You should add the current execs and a section for Significant Alumni
- Append all their contacts
- They should be easily reachable by just one click
Events Section
- Update the events timeline.
- If there is any upcoming event, it should be updatable easily
- Provide form for notification via email address.
Meet AGGES Alumni
- Add a brief profile of a few Alumni (Selected by the Matron, CoD GEGIS)
- Add their quick links and social media links e.g LinkedIn (Prefered), Github, Twitter
- Append a short message to the AGGES Students
Potential Companies
- Some comapnies that we should associate ourselves with.
- We prefer those Geospatial/Survey companies that our Alumni work (Or have worked with) and are really promising
- Do they offer our students internships?, Prefer them
Membership
- Enable away of contacting the leaders to join AGGES
Projects
- Add a small description of each project, and include a cover photo to each proj if possible.
- Provide links for individual project contents
- Here is a saample curated list of GEGIS BSc. Projects for 2020. It will be a ice idea to append them too.
GEGIS(GIS) Past Papers
- Add a section where students can view and access revision papers for any unit of their choice
Contact us
- Creaate a interactive webMap pointing to JKUAT GEGIS Department on the map.
- Make feedback button clear.
- Center the contents.
- Provide accurate links for the various external links.
Yearly Archive
- Archive for the various members profile photos.
- The position they held.
- Events in that year.
Blog
- Make it have same design as the parent website.
- Redesign the blog section, so that one can be able to create profile, write a blogs and get user feedback via comments and claps.
- Make it a better place.
Choose one of the following technical tracks to build the functionality described in the Functional spec that best suits your skill set:
- Back-end track: build a REST API and include a minimal front-end (e.g. a browsable API)
- Front-end track: build your project as a purely client-side app
- Full Stack: blend the former approaches, but be sure to demonstrate your competence across the stack
- We prefer adoption of HTML, CSS and Javascript for this stack. However you can use any tool to make your web design upto the desired appeal.
- Your project can be built using any JavaScript or CSS framework, though we encourage ReactJS, Redux and CSS/SCSS. You are also welcome to use our React-ions library to help build your UI.
Alternatively, feel free to swap out similar JavaScript frameworks such as Angular and UI kits such as Bootstrap. In addition to building the application.
-
You can use any database of your choice to enable storage of the various archives.
-
Your task is to build a REST API that can support the functionality of the site. Your project can be built using any API framework/language, though we encourage the use of Django Rest Framework/Python. Your API should be able to:
-
Perform CRUD actions for the gallery page, blog page, archive page, events page and about page.
-
Perform analytics from the page e.g number of visits per day, user location
You do not have to build a functional UI unless you want to show off your talents across the stack. We will test your API by using the Browsable API. You are encouraged to write tests to verify your own results.
In your repo, please include the following items in your README:
- Whether the solution focuses on back-end, front-end or full stack.
- Reasoning behind your technical choices, including architecture.
- Trade-offs you might have made, anything you left out, or what you might do differently if you were to spend additional time on the project.
- Link to the hosted application (where applicable).
This will give us insight into how you approached the challenge.
- Comment your code to show your thought process
- Submit this web design as a directory in your pull request named "{yourname_Task}"
- Make sure your have deployed your site to netlify, heroku or github pages
- Deploying site to heroku
- Deploying site to netlify
- Deploying site to github page
- Another reference for github pages
- Fork the code challenge repository provided here.
- Then git clone the forked repo by running this command in your local terminal
- Clone (Download) the remote repo to your local working machine:
$ git clone https://github.com/myUsername/AggesWebsiteChallenge2021.git- Make a topic branch. In your github, keep the main branch clean. Pull all changes, make sure your repository is up to date.
$ cd AggesWebsiteChallenge2021
git pull origin main- Create a new branch as follows
$ git checkout -b <your_branch_name>
e.g
git checkout -b frontend- See all branches created
$ git branch
main
* <your_branch_name>- Pull the remote changes locally
$ git pull- Push the new branch to github
$ git push origin -u <your_branch_name>-
Make changes to the fork following the challenge provided.
-
Check the status of the repo
$ git status- Add your changed files
$ git add .
$ git status- Commit your changes
git commit -m "Commit message 😇"- Push your code changes
git push --set-upstream origin your_branch_name- Make a pull request to the AggesWebsiteChallenge2021 Repo.
Submissions later than 0900hr EAT on 30th March 2021 will not be considered
- JKUAT SES was a starting point to get us started