{"id":21894108,"url":"https://github.com/hackgt/projectideas-onboarding","last_synced_at":"2026-04-07T07:45:09.750Z","repository":{"id":55276886,"uuid":"324239952","full_name":"HackGT/projectideas-onboarding","owner":"HackGT","description":"HexLabs 2022 Onboarding Project ","archived":false,"fork":false,"pushed_at":"2023-02-05T16:46:34.000Z","size":616,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"startercode","last_synced_at":"2026-01-03T16:26:29.870Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/HackGT.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-12-24T21:36:37.000Z","updated_at":"2023-01-17T16:38:50.000Z","dependencies_parsed_at":"2023-02-16T09:01:37.786Z","dependency_job_id":null,"html_url":"https://github.com/HackGT/projectideas-onboarding","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/HackGT/projectideas-onboarding","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackGT%2Fprojectideas-onboarding","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackGT%2Fprojectideas-onboarding/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackGT%2Fprojectideas-onboarding/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackGT%2Fprojectideas-onboarding/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/HackGT","download_url":"https://codeload.github.com/HackGT/projectideas-onboarding/tar.gz/refs/heads/startercode","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/HackGT%2Fprojectideas-onboarding/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31504897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T03:10:19.677Z","status":"ssl_error","status_checked_at":"2026-04-07T03:10:13.982Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-11-28T13:18:57.488Z","updated_at":"2026-04-07T07:45:09.730Z","avatar_url":"https://github.com/HackGT.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HackGT Tech Onboardnig\n\nWelcome to the HackGT tech onboarding project. This will serve as an introduction to TypeScript/JavaScript, Node.js, MongoDB, and React. You'll be making a Project Ideas dashboard! You can see a demo @ [https://ideas.dev.hack.gt](https://ideas.dev.hack.gt).\n\nThis README has the following sections:\n\n- [Installation](#Installation)\n- [Learning Links](#Learning-Links)\n- [Setup](#Setup)\n\nPlease follow the installation instructions in order, since later tools may depend on installing previous tools first.\n\n## Installation\n\n### Xcode Command-Line Tools\n\nIf you're on macOS, you will need to install Xcode Command-Line tools first. This is a setup of basic development tools and utilities you'll need first. Be warned that it can take a while to install. You can install it by running `xcode-select --install`.\n\n### Homebrew\n\nIf you're on macOS or Linux, you should first install Homebrew. It's essentially a package manager for your computer (you'll need it to install tools like MongoDB).\n\n[Here](https://brew.sh/) are the installation instructions. Test that its installed by typing in `brew --version`\n\n### Node.js and npm\n\nYou can download Node.js [here](https://nodejs.org/en/). Select the button saying \"Recommended For Most Users\".\n\nnpm stands for Node Package Manager, though it's name is confusing since it can also be used on the frontend. npm is automatically distributed with Node.js.\n\nTo check that you have Node and npm installed, run these commands in your terminal.\n\n- `node -v`\n- `npm -v`\n\nIf these commands return a number like `v12.18.1` you're good to go.\n\n### yarn\n\nTo install Yarn, go [here](https://classic.yarnpkg.com/en/docs/install). After installing, test that it's installed by running `yarn --version`.\n\n### MongoDB\n\n[Here](https://docs.mongodb.com/manual/administration/install-community/) are the installation instructions for MongoDB Community Edition. Check that it's installed by running `mongo --version`.\n\n### MongoDB Compass\n\nMongoDB Compass is a GUI for your database that allows you to easily interact with it and view data. Download it [here](https://www.mongodb.com/try/download/compass)\n\n### VSCode\n\nThe easiest code editor to get started with is VSCode. Please don't use Sublime :). You can download it [here](https://code.visualstudio.com/download).\n\n### Postman\n\nPostman is an app that allows you to test your backend code by sending different types of requests. You can download it [here](https://www.postman.com/downloads/).\n\n## Learning Links\n\nOn most coding projects, you'll likely be using a wide number of tools, frameworks, and languages, and you'll constantly be learning new ones as projects rise and fall in popularity. As such, here are some cool resources to help you learn the tools we use at HackGT.\n\n### JavaScript and TypeScript\n\n- Modern JavaScript Tutorial [https://javascript.info/](https://javascript.info/)\n- JavaScript tutorial [https://www.tutorialrepublic.com/javascript-tutorial/](https://www.tutorialrepublic.com/javascript-tutorial/)\n- TypeScript for new programmers [https://www.typescriptlang.org/docs/handbook/typescript-from-scratch.html](https://www.typescriptlang.org/docs/handbook/typescript-from-scratch.html)\n\n### React\n\n- Amazing slides made my Tim Aveni, HackGT alum [https://tja.io/hackgt5/slides/](https://tja.io/hackgt5/slides/)\n- A great getting started guide with React [https://www.taniarascia.com/getting-started-with-react/](https://www.taniarascia.com/getting-started-with-react/)\n- Honestly, the official React docs are great themselves [https://reactjs.org/docs/hello-world.html](https://reactjs.org/docs/hello-world.html)\n\n### Node.js and Express.js\n\n- Node.js/Express overview [https://developer.mozilla.org/en-US/docs/Learn/Server-side/Express_Nodejs/Introduction](https://developer.mozilla.org/en-US/docs/Learn/Server-side/Express_Nodejs/Introduction)\n- In depth Node.js [https://nodejs.dev/learn](https://nodejs.dev/learn)\n- Official Express getting started [https://expressjs.com/en/starter/hello-world.html](https://expressjs.com/en/starter/hello-world.html)\n\n### MongoDB and Mongoose\n\n- MongoDB tutorial [https://www.freecodecamp.org/news/learn-mongodb-a4ce205e7739/](https://www.freecodecamp.org/news/learn-mongodb-a4ce205e7739/)\n- Mongoose introduction [https://www.freecodecamp.org/news/introduction-to-mongoose-for-mongodb-d2a7aa593c57/](https://www.freecodecamp.org/news/introduction-to-mongoose-for-mongodb-d2a7aa593c57/)\n\n## Setup\n\n### Git\n\nWhen developing this onboarding project, please make a new branch with your first name, and use that branch for development. For example, make a branch with `git branch rahul`, and check it out with `git checkout rahul`. As you make commits, you can push to the repo with `git push`.\n\n**Important** Please do not push any commits on the main branch, only push commits on your specific branch!\n\n### Overview\n\nThe code for this project is split up between the `client` and `server` folders (ie frontend and backend). Before reading below, please open up Terminal (on Mac) or Command Prompt (on Windows) and navigate to this folder. If you've never used the command line before, look at this quick [cheat sheet](https://enexdi.sciencesconf.org/data/pages/windows_vs_mac_commands_1.pdf).\n\n**Important** In total, you will need 3 different terminal windows/tabs to run all the code. One to run the MongoDB database, one to run the backend, and one to run the frontend.\n\n### Database - Getting Started\n\nIf you're on Windows, follow this step to start your MongoDB server.\n\n1. In the terminal window, type `mongo` to start the MongoDB database. This creates a local database instance on your computer.\n\nIf you're on Mac, you can get it started with brew services.\n\n1. Visit the docs [here](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-os-x/#installing-mongodb-5.0-edition-edition)\n\n### Backend - Getting Started\n\nBefore getting started, make sure to get the environment variables from your tech director and place them in a file called `.env` in the `/server` folder. Otherwise, you won't be able to run your code!\n\nIn a different terminal window/tab, complete the following steps.\n\n1. `cd server` (Navigate to server folder)\n2. `yarn install` (Install dependencies from package manager)\n3. `yarn dev` (Start backend dev server)\n\nNavigate to [localhost:3000](localhost:3000) to see the backend server.\n\n### Frontend - Getting Started\n\n**Important** Please start your backend server before starting your frontend one, as the code uses a proxy to send your requests between the client and server.\n\n1. `cd client` (Navigate to client folder)\n2. `yarn install` (Install dependencies from package manager)\n3. `yarn start` (Start frontend dev server)\n4. When the prompt says `Something is already running on port 3000` etc, type y to continue\n\nNavigate to [localhost:3001](localhost:3001) to see the frontend server.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackgt%2Fprojectideas-onboarding","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhackgt%2Fprojectideas-onboarding","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhackgt%2Fprojectideas-onboarding/lists"}