{"id":22403100,"url":"https://github.com/hellocoop/hello-nextjs-sample","last_synced_at":"2025-07-31T16:31:34.935Z","repository":{"id":196404925,"uuid":"695274364","full_name":"hellocoop/hello-nextjs-sample","owner":"hellocoop","description":"Hellō Next.js Sample","archived":false,"fork":false,"pushed_at":"2024-08-12T23:40:33.000Z","size":203,"stargazers_count":7,"open_issues_count":2,"forks_count":16,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-08-13T21:20:49.171Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hello-nextjs-sample.vercel.app","language":"JavaScript","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/hellocoop.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":"2023-09-22T18:36:47.000Z","updated_at":"2024-08-12T23:40:09.000Z","dependencies_parsed_at":"2023-09-26T10:30:54.818Z","dependency_job_id":"84e22b2e-9397-4aae-8421-ad731ab75e87","html_url":"https://github.com/hellocoop/hello-nextjs-sample","commit_stats":null,"previous_names":["hellocoop/hello-nextjs-starter","hellocoop/hello-nextjs-sample"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2Fhello-nextjs-sample","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2Fhello-nextjs-sample/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2Fhello-nextjs-sample/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hellocoop%2Fhello-nextjs-sample/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hellocoop","download_url":"https://codeload.github.com/hellocoop/hello-nextjs-sample/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":228267815,"owners_count":17893841,"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-12-05T09:16:08.781Z","updated_at":"2025-07-31T16:31:34.926Z","avatar_url":"https://github.com/hellocoop.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Hellō Next.js Sample\n\nThis is a sample application for the Hellō Next.js SDK [@hellocoop/nextjs](https://www.npmjs.com/package/@hellocoop/nextjs)\n\nYou can have this app running fully configured on localhost in a minute, and then deploy to Vercel fully configured a minute later.\n\n1. [Fork and clone this repository to your GitHub account](#1-fork-and-clone-this-repository-to-your-github-account)\n2. [ Install, configure, and run!](#2-install-configure-and-run)\n3. [Check in updates \u0026 deploy to Vercel](#3-check-in-updates--deploy-to-vercel)\n   \nSee a deployed version  at [https://hello-nextjs-sample.vercel.app](https://hello-nextjs-sample.vercel.app) \n\n\u003e If you want to add Hellō to your own Next.js app, we have a [Quickstart](https://www.hello.dev/docs/quickstarts/nextjs/) for that!\n\nHere is a video that forks, clones, installs, configures, runs locally and then deploys to Vercel:\n\n[![Hellō Auto Config Demo Video](https://img.youtube.com/vi/-5Dc9CVxeU4/maxresdefault.jpg)](https://www.youtube.com/watch?v=-5Dc9CVxeU4)\nhttps://youtu.be/-5Dc9CVxeU4\n\nTo run locally, you will need:\n\n- [nodejs 18+](https://nodejs.org/en/download)\n- [git](https://github.com/git-guides/install-git)\n- A [GitHub](https://github.com) account\n\n## 1\\. Fork and clone this repository to your GitHub account\n\n\u003chttps://github.com/hellocoop/hello-nextjs-sample/fork\u003e\n\n[How to clone a repository](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)\n\nYou should now have a `hello-nextjs-sample` directory on your machine with the contents of this repo.\n\n## 2\\. Install, configure, and run!\n\nRun these commands to start running locally:\n\n```sh\ncd hello-nextjs-sample\nnpm install\nnpm run quickstart\n```\nYou should see a prompt to hit ENTER to open the browser.  Once the browser is open, follow the steps to update your local environment with the necessary configuration.\n\nOnce completed, you will now have the necessary configuration and environment variables. Continue by running the following: \n\n```\nnpm run dev\n```\n\nOpen \u003chttp://localhost:3000\u003e (assuming port 3000 was free)\n\nClick the `[ ō Continue with Hellō ]` button to login. You will be sent to the Hellō Wallet. As you have not added a logo or urls, you will see placeholders.\n\n## 3\\. Check in updates \u0026 deploy to Vercel\n\nYou will need:\n\n- A [Vercel](https://vercel.com) account *linked to your GitHub account* so it can access the repo you just created\n- Vercel CLI that is logged into your Vercel account \n\nThe following commands will install the Vercel CLI and login\n\n```sh\nnpm install -g vercel\nvercel login\n```\n\nThe following commands will:\n- check in the Quickstart updates to your repo\n- link this project to your Vercel account\n- set HELLO_COOKIE_SECRET values in Vercel\n- deploy this sample to Vercel\n- load the deployed site\n\n```sh\ngit commit -a -m\"quickstart\"\ngit push origin\nvercel link --yes\nnpm run config:vercel\n```\nFor Windows systems, run:\n```\nFor /f %i in ('vercel --yes') do set \"DEPLOYMENT=%i\"\nnpx open-cli %DEPLOYMENT%\n```\n\notherwise, run:\n```\nDEPLOYMENT=$(vercel --yes)\nnpx open-cli $DEPLOYMENT\n```\n\n\u003e We have had a report that `vercel link --yes` may fail. We have not been able to replicate. If it fails, please run `vercel link --yes --debug`. You can likely work around it with `vercel link` and accept all defaults.\n\nNo other configuration needed at Vercel!\n\nTo delete the Vercel deployment:\n```sh\nvercel remove hello-nextjs-sample --yes\n```\n\n# How Configuration Works\n\nThe Hellō Quickstart Web App;\n- created your application at Hellō, returned your `client_id`, and added it to the `hello.config.ts` file\n- generated a random `HELLO_COOKIE_SECRET` and wrote it to `env.local`\n\nYou are able to use your app on your own machine immediately as `http://localhost:*` Redirect URIs are enabled for your development team by default.\n\nThe `npm run config:vercel` generates new `HELLO_COOKIE_SECRET` values and sets them in the Vercel `production`, `preview`, and `development` environments. \n\nAfter deploying the app to Vercel, you are able to access your app when deployed as we have enabled `https://*` Redirect URIs for members of your development team. The first time you login to your deployed app, the [@hellocoop/nextjs](https://www.npmjs.com/package/@hellocoop/nextjs) package auto configures the `redirect_uri`, and on return you will be prompted to add the Redirect URI to your app at the [Hello Developer Console](https://console.hello.coop/). For `preview` deployments you only want your team to access, add to your Development Redirect URIs, for production or deployments you want others to access, add to your Production Redirect URIs.\n\n## Learn More\n\n- [Hellō Next.js SDK](https://www.npmjs.com/package/@hellocoop/nextjs)\n- [Hellō Quickstart](https://www.npmjs.com/package/@hellocoop/quickstart)\n- [Hellō Documentation](https://www.hello.dev/documentation)\n  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhellocoop%2Fhello-nextjs-sample","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhellocoop%2Fhello-nextjs-sample","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhellocoop%2Fhello-nextjs-sample/lists"}