{"id":22989535,"url":"https://github.com/biomathcode/helpme-hackathon","last_synced_at":"2025-08-18T19:09:28.207Z","repository":{"id":110849052,"uuid":"374424842","full_name":"biomathcode/HelpMe-hackathon","owner":"biomathcode","description":"find someone you can help near you","archived":false,"fork":false,"pushed_at":"2021-06-07T13:09:15.000Z","size":4152,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-02T11:49:37.278Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/biomathcode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","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":"2021-06-06T17:39:00.000Z","updated_at":"2021-06-23T03:49:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"83b1f034-ad12-41b1-9e97-3ead347f2c2e","html_url":"https://github.com/biomathcode/HelpMe-hackathon","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/biomathcode/HelpMe-hackathon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biomathcode%2FHelpMe-hackathon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biomathcode%2FHelpMe-hackathon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biomathcode%2FHelpMe-hackathon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biomathcode%2FHelpMe-hackathon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/biomathcode","download_url":"https://codeload.github.com/biomathcode/HelpMe-hackathon/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biomathcode%2FHelpMe-hackathon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271043932,"owners_count":24689859,"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","status":"online","status_checked_at":"2025-08-18T02:00:08.743Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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-12-15T04:17:51.814Z","updated_at":"2025-08-18T19:09:28.183Z","avatar_url":"https://github.com/biomathcode.png","language":"JavaScript","readme":"[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://grandstack.io/deploy-starter-netlify) [![Deploy to Vercel](https://vercel.com/button)](https://grandstack.io/deploy-starter-vercel) [![Provision Neo4j](https://grandstack.io/img/provision-neo4j.png)](https://sandbox.neo4j.com/?usecase=blank-sandbox)\n\n# GRANDstack Starter\n\n```\nnpx create-grandstack-app myNewApp\n```\n\nThis project is a starter for building a [GRANDstack](https://grandstack.io) (GraphQL, React, Apollo, Neo4j Database) application. There are two components to the starter, the web frontend application (in React and Angular flavors) and the API app (GraphQL server).\n\nThe starter represents a **business reviews dashboard**. You need to adjust the GraphQL schema, the seed data, database index creation, and the UI components for your use-case.\n\n[![Hands On With The GRANDstack Starter](http://img.youtube.com/vi/rPC71lUhK_I/0.jpg)](http://www.youtube.com/watch?v=1JLs166lPcA 'Hands On With The GRANDstack Starter')\n\n_Hands On With The GRANDstack Starter Video_\n\n## Quickstart\n\nThe easiest way to get started with the GRANDstack Starter is to create a Neo4j Sandbox instance and use the `create-grandstack-app` command line tool.\n\n(If you have a running Neo4j database on localhost via Neo4j Desktop or a Neo4j server installation, change the password in `api/.env`)\n\n### 1. Create A Neo4j Instance\n\n#### Option :one: - Sandbox\n\n[Neo4j Sandbox](https://neo4j.com/sandbox) allows you to create a free hosted Neo4j instance private to you that can be used for development.\n\nAfter signing in to Neo4j Sandbox, click the `+ New Project` button and select the \"Blank Sandbox\" option. In the next step we'll use the connection credentials from the \"Connection details\" tab to connect our GraphQL API to this Neo4j instance.\n\n![Neo4j Sandbox connection details](img/neo4j-sandbox.png)\n\n#### Option :two: - Desktop\n\nIf you instead would like to use [Neo4j Desktop](https://neo4j.com/download/). The process will be almost the same with a minor detour. Install Neo4j Desktop for your chosen OS and then make a new blank graph for your project. It will require you to put in a password and username. Remember those.\n\nNext you need to go to open the manage screen from the options in the 3 dot stack menu\n\n![New desktop graph, manage tab](img/desktop-new-graph.png)\n\nAnd install the apoc plugin, green button at the top of the list.\n\n![Plugins](img/apoc-install.png)\n\nAfter that you can return to setting up your app with the credentials from the prior steps.\n\n### 2. Run the `create-grandstack-app` CLI\n\n```\nnpx create-grandstack-app myNewApp\n```\n\nor with Yarn\n\n```\nyarn create grandstack-app myNewApp\n```\n\n![create grandstack app output](img/create-grandstack-app.png)\n\nThis will create a new directory `myNewApp`, download the latest release of the GRANDstack Starter, install dependencies and prompt for your connection credentials for Neo4j to connect to the GraphQL API.\n\n### 3. Seed the database (optional)\n\nMake sure your application is running locally with `npm start` or `yarn start`, open another terminal and run\n\n```\nnpm run seedDb\n```\n\nor with Yarn\n\n```\nyarn run seedDb\n```\n\n### 4. Open In Browser\n\n![Grandstack app running in browser](img/grandstack-app.png)\n\n## \u003ca name=\"overview\"\u003e\u003c/a\u003e Overview\n\nThe GRANDstack Starter is a monorepo that includes a GraphQL API application and client web applications for React (default) and Angular for a business reviews dashboard.\n\n### `/` - Project Root\n\nThe root directory contains some global configuration and scripts:\n\n- `npm run start` and `npm run build`\n- ESLint (.eslintrc.json) for code linting\n- Prettier (.prettierrc.json) for code formatting\n- Git hooks for applying formatting on commit\n\n### [`/api`](./api)\n\n![](img/graphql-playground.png)\n\nThis directory contains the GraphQL API application using Apollo Server and the Neo4j GraphQL Library.\n\n- Change environment variable settings in `.env`:\n\n```\n# Use this file to set environment variables with credentials and configuration options\n# This file is provided as an example and should be replaced with your own values\n# You probably don't want to check this into version control!\n\nNEO4J_URI=bolt://localhost:7687\nNEO4J_USER=neo4j\nNEO4J_PASSWORD=letmein\n\n# Uncomment this line to enable encrypted driver connection for Neo4j\n#NEO4J_ENCRYPTED=true\n\n# Uncomment this line to specify a specific Neo4j database (v4.x+ only)\n#NEO4J_DATABASE=neo4j\n\nGRAPHQL_SERVER_HOST=0.0.0.0\nGRAPHQL_SERVER_PORT=4001\nGRAPHQL_SERVER_PATH=/graphql\n\n```\n\n### [`/web-react`](./web-react)\n\n![](img/grandstack-app.png)\n\nThe frontend React web application is found in this directory.\n\nIt includes:\n\n- Material UI\n- React router\n- Apollo Client / React Hooks\n- Create React App\n\n### [`/web-angular`](./web-angular)\n\n![](web-angular/img/angular-ui.jpg)\n\nA UI built with [Angular](https://angular.io), [Apollo](https://www.apollographql.com/docs/angular/) and the [Clarity Design System](https://clarity.design) is also available.\n\n_Start the Angular UI server_\n\n```\ncd ./web-angular \u0026\u0026 npm start\n```\n\n### [`/mobile_client_flutter`](./mobile_client_flutter)\n\n![](img/grandstack-flutter.png)\n\nA mobile client built with [Flutter](https://flutter.dev) which supports Android, iOS, and web. See the [README](./mobile_client_flutter/README.md) for detailed setup instructions.\n\n```\ncd ./mobile_client_flutter \u0026\u0026 flutter run\n```\n\n### [`/web-react-ts`](./web-react-ts)\n\nA UI built with [CRA](https://reactjs.org/docs/create-a-new-react-app.html)\n\n_Start the React dev server_\n\n```\ncd ./web-react-ts \u0026\u0026 npm start\n```\n\n## Deployment\n\n### Netlify\n\nThis monorepo can be deployed to Netlify. The frontend application will be served over Netlify's CDN and the GraphQL API will be provisioned as a serverless GraphQL API lambda function deployed to AWS (via Netlify). A netlify.toml file is included with the necessary build configurations. The following environment variables must be set in Netlify (either via the Netlify web UI or via the command line tool)\n\n```\nNEO4J_URI\nNEO4J_USER\nNEO4J_PASSWORD\n```\n\nSee the \"Hands On With The GRANDStack Starter\" video linked at the beginning of this README for a walkthrough of deploying to Netlify.\n\n### Vercel\n\nVercel can be used with monorepos such as grand-stack-starter. [`vercel.json`](https://github.com/grand-stack/grand-stack-starter/blob/master/vercel.json) defines the configuration for deploying with Vercel.\n\n1. get [vercel cli](https://vercel.com/download)\n2. Set the vercel secrets for your Neo4j instance:\n\n```\nvercel secret add grand_stack_starter_neo4j_uri bolt://\u003cYOUR_NEO4J_INSTANCE_HERE\u003e\nvercel secret add grand_stack_starter_neo4j_user \u003cYOUR_DATABASE_USERNAME_HERE\u003e\nvercel secret add grand_stack_starter_neo4j_password \u003cYOUR_DATABASE_USER_PASSWORD_HERE\u003e\n```\n\n3. Run `vercel`\n\n## Docker Compose\n\nYou can quickly start via:\n\n```\ndocker-compose up -d\n```\n\nIf you want to load the example DB after the services have been started:\n\n```\ndocker-compose run api npm run seedDb\n```\n\nSee [the project releases](https://github.com/grand-stack/grand-stack-starter/releases) for the changelog.\n\nYou can find instructions for other ways to use Neo4j (Neo4j Desktop, Neo4j Aura, and other cloud services) in the [Neo4j directory README.](./neo4j)\n\nThis project is licensed under the Apache License v2.\nCopyright (c) 2020 Neo4j, Inc.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiomathcode%2Fhelpme-hackathon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbiomathcode%2Fhelpme-hackathon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiomathcode%2Fhelpme-hackathon/lists"}