{"id":17070513,"url":"https://github.com/oakmac/phase1-final-project-requirements","last_synced_at":"2025-09-08T11:07:41.534Z","repository":{"id":66970626,"uuid":"157438121","full_name":"oakmac/phase1-final-project-requirements","owner":"oakmac","description":"Final Project Requirements for Phase 1 - DigitalCrafts Flex coding bootcamp","archived":false,"fork":false,"pushed_at":"2020-03-25T01:26:02.000Z","size":17,"stargazers_count":4,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-28T17:26:07.380Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oakmac.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-13T19:56:58.000Z","updated_at":"2022-03-09T02:37:49.000Z","dependencies_parsed_at":null,"dependency_job_id":"f6cd881e-6523-481d-ae06-2f33dca012c5","html_url":"https://github.com/oakmac/phase1-final-project-requirements","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oakmac%2Fphase1-final-project-requirements","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oakmac%2Fphase1-final-project-requirements/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oakmac%2Fphase1-final-project-requirements/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oakmac%2Fphase1-final-project-requirements/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oakmac","download_url":"https://codeload.github.com/oakmac/phase1-final-project-requirements/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245090875,"owners_count":20559298,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-14T11:31:59.561Z","updated_at":"2025-03-23T11:14:09.164Z","avatar_url":"https://github.com/oakmac.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Final Phase 1 Group Project Requirements\n\nThis is the final project for \"Phase 1\" of the Flex course for [DigitalCrafts]\nHouston.\n\n\u003e NOTE: You must complete this project in accordance with the requirements laid out\n  below in order to fulfill Texas state requirements for credit for the course. If\n  you have any questions or concerns about the requirements, please see an\n  instructor.\n\n[DigitalCrafts]:https://www.digitalcrafts.com/\n\n## Project Description\n\nYour task is to build an awesome web application as a group! Mix and match\nlibraries and APIs to build a useful front-end web application.\n\nYou will be using the front-end skills you have developed throughout Phase 1:\nHTML, CSS, JavaScript, AJAX, Bootstrap, APIs, etc.\n\n## Technical Requirements\n\nYour application **must**:\n\n- Use at least one JavaScript library that is not jQuery. Examples:\n  - [Moment.js](https://momentjs.com/)\n  - [Marked](https://marked.js.org/)\n  - [jQuery UI](https://jqueryui.com/)\n  - [chessboard.js](http://chessboardjs.com/)\n  - [Additional List](./additional-libraries.md)\n\n- Use a CSS framework. Examples:\n  - [Bootstrap](http://getbootstrap.com/)\n  - [Bulma](https://bulma.io/)\n  - [Foundation](https://foundation.zurb.com/)\n\n- Access at least two remote APIs using AJAX. Examples:\n  - [Firebase](https://firebase.google.com/)\n  - [TheCatAPI](https://thecatapi.com/)\n  - [Google Maps](https://developers.google.com/maps/documentation/)\n  - [Big List of Public APIs](https://github.com/toddmotto/public-apis)\n  - [Another Big List of Public APIs](https://github.com/abhishekbanthia/Public-APIs)\n  - Note that loading a JavaScript or CSS library from a CDN does not fulfill this requirement.\n    You must use AJAX.\n\n- Your project must have a `README.md` file written using [Markdown] with at least the following:\n  - Explanation of what the project is / what it does.\n  - What technologies you used.\n  - List of team members.\n\n- Deployment of your application to somewhere other than GitHub Pages. Examples:\n  - [Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html)\n  - [Google Cloud](https://cloud.google.com/storage/docs/hosting-static-website)\n  - [Netlify](https://www.netlify.com/)\n  - [Neocities](https://neocities.org/)\n  - [Surge](https://surge.sh/)\n  - Note that you do not need to purchase a domain name for your project. But it\n    should be reachable via a public URL somewhere.\n\n- Your repo must be connected to [Travis CI](https://travis-ci.org/):\n  - You must run at least one test in your Travis CI build (hint: test for [StandardJS])\n  - Put a build status badge in your `README.md` that links to your latest build\n\n- Code must follow some organization scheme.\n  - Everything cannot be in one super long file.\n  - Break different parts of the code into different files / modules.\n  - No \"spaghetti code\".\n  - Bonus / optional: consider using a build system with [npm scripts], [browserify], or [webpack]\n\n[Markdown]:https://guides.github.com/features/mastering-markdown/\n[StandardJS]:https://standardjs.com/\n[npm scripts]:https://deliciousbrains.com/npm-build-script/\n[browserify]:http://browserify.org/\n[webpack]:https://webpack.js.org/\n\n## Workflow Requirements\n\n- Teams will be groups of 3-5 students and assigned by instructors.\n\n- Create one GitHub repo and add all group members as collaborators.\n\n- Collaborate using Pull Requests (PRs):\n  - No one should commit to the master branch directly.\n  - Every PR should be reviewed and approved by at least one team member (not the person who originated the PR).\n  - PRs should not be merged by the person who opened it (no self-merging).\n  - See below for [suggested PR rejection criteria](#suggested-pr-rejection-criteria)\n\n- Project features and bugs must be tracked using a [scrum]-like system:\n  - Every PR should be associated with a GitHub Issue (or similar).\n  - Consider using a tool like [GitHub Project Board] or [Trello].\n  - Every class day teams will have a \"stand up meeting\" with a TA or Instructor.\n\n[scrum]:https://en.wikipedia.org/wiki/Scrum_(software_development)\n[GitHub Project Board]:https://help.github.com/articles/about-project-boards/\n[Trello]:https://trello.com/\n\n## Suggested PR Rejection Criteria\n\nIt's ok to reject a PR or have a PR rejected - that is what the PR process is\nfor! Remember if your PR is rejected that doesn't mean you are a bad person and\nstink at life. It just means that your teammate(s) see something that could be\nimproved. The PR process is more about sharing knowledge than \"you did something\nwrong\".\n\nAny of the following are valid reasons to reject a PR:\n\n- Breaks the build (Travis CI breaks)\n- Does not fulfill feature\n- Breaks other feature\n- Does not follow team coding style / standards\n- Too much to review / large code diff (ie: should be broken up into smaller PRs)\n- Code in the PR does not match up with commit message\n- Commit message is vague\n\n## Learning Objectives\n\nBy the end of Phase 1 you should have most of the skills necessary to understand\nmuch of the world of web development (HTML, CSS, JavaScript). The intent with\nthese requirements is for each student in the group to use these skills to learn\nsomething new and use it in a \"real world\" way. Searching for external resources\nand being able to understand and apply documentation is a big part of software\ndevelopment. Whether it is an API, a new JavaScript library, deployment,\ntesting, etc. Go learn something new and put those web development skills to\nwork!\n\nAnother goal of this project is polish / thoroughness. A thorough `README.md`,\ntesting via Travis CI, deploying to a public web server, thoughtful commit\nmessages, following a PR review process, good code organization, etc are all\nsignals of quality software development. The end result of this project should\nbe a portfolio piece that you are excited to put on your resume and share with\nfriends and family: \"Hey - look at this cool thing I built!\" Look for\nopportunities to polish and show the world what you can do!\n\n--------------------------------------------------------------------------------\n\nThis requirements document is licensed as [CC0 1.0 Universal](https://creativecommons.org/publicdomain/zero/1.0/):\n\n\u003e You can copy, modify, distribute and perform the work, even for commercial purposes, all without asking permission.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foakmac%2Fphase1-final-project-requirements","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foakmac%2Fphase1-final-project-requirements","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foakmac%2Fphase1-final-project-requirements/lists"}