{"id":15726837,"url":"https://github.com/usulpro/datocms-datocms-sample","last_synced_at":"2025-03-31T01:48:54.300Z","repository":{"id":82554233,"uuid":"427125635","full_name":"usulpro/datocms-datocms-sample","owner":"usulpro","description":null,"archived":false,"fork":false,"pushed_at":"2021-11-11T19:55:50.000Z","size":17763,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-06T07:12:10.967Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/usulpro.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":"2021-11-11T19:54:33.000Z","updated_at":"2022-10-09T12:00:48.000Z","dependencies_parsed_at":"2023-03-12T16:09:59.986Z","dependency_job_id":null,"html_url":"https://github.com/usulpro/datocms-datocms-sample","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/usulpro%2Fdatocms-datocms-sample","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usulpro%2Fdatocms-datocms-sample/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usulpro%2Fdatocms-datocms-sample/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/usulpro%2Fdatocms-datocms-sample/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/usulpro","download_url":"https://codeload.github.com/usulpro/datocms-datocms-sample/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246403896,"owners_count":20771526,"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-03T22:40:50.857Z","updated_at":"2025-03-31T01:48:54.267Z","avatar_url":"https://github.com/usulpro.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# A Blog example using Next.js and DatoCMS\n\nThis example showcases a Next.js Blog using [DatoCMS](https://www.datocms.com/) as the data source. It fully supports [Preview Mode](https://www.datocms.com/docs/next-js/setting-up-next-js-preview-mode) with [DatoCMS real-time updates](https://www.datocms.com/docs/next-js/real-time-updates).\n\nThe purpose of this repo is to have a quick start reference that can be set up with the \"one-click\" button below.\n\n## Demo\n\nHave a look at the end result live:\n\n### [https://nextjs-demo-bay.vercel.app/](https://nextjs-demo-bay.vercel.app/)\n\n## How to use\n\n### Quick start\n\n1. [Create an account on DatoCMS](https://datocms.com).\n\n2. Make sure that you have set up the [Github integration on Vercel](https://vercel.com/docs/git/vercel-for-github).\n\n3. Let DatoCMS set everything up for you clicking this button:\n\n[![Deploy with DatoCMS](https://dashboard.datocms.com/deploy/button.svg)](https://dashboard.datocms.com/deploy?repo=datocms/nextjs-demo)\n\n### Local setup\n\nOnce the setup of the project and repo is done, clone the repo locally.\n\n#### Set up environment variables\n\nIn your DatoCMS' project, go to the **Settings** menu at the top and click **API tokens**.\n\nThen click **Read-only API token** and copy the token.\n\nNext, copy the `.env.example` file in this directory to `.env` (which will be ignored by Git):\n\n```bash\ncp .env.example .env\n```\n\nThen set each variable on `.env`:\n\n- `NEXT_EXAMPLE_CMS_DATOCMS_API_TOKEN` should be the API token you just copied.\n- `NEXT_EXAMPLE_CMS_DATOCMS_PREVIEW_SECRET` can be any random string (but avoid spaces), like `MY_SECRET` - this is used for the Preview Mode](https://www.datocms.com/docs/next-js/setting-up-next-js-preview-mode).\n\nYour `.env` file should look like this:\n\n```bash\nNEXT_EXAMPLE_CMS_DATOCMS_API_TOKEN=...\nNEXT_EXAMPLE_CMS_DATOCMS_PREVIEW_SECRET=...\n```\n\n#### Run your project locally\n\n```bash\nnpm install\nnpm run dev\n```\n\nYour blog should be up and running on [http://localhost:3000](http://localhost:3000)!\n\n#### Try preview mode\n\nOn DatoCMS, go to one of the posts you've created and:\n\n- **Update the title**. For example, you can add `[Draft]` in front of the title.\n- Click **Save**, but **DO NOT** click **Publish**. By doing this, the post will be in the draft state.\n\n(If it doesn't become draft, you need to go to the model settings for `Post`, go to **Additional Settings**, and turn on **Enable draft/published system**.)\n\nNow, if you go to the post page on localhost, you won't see the updated title. However, if you use the **Preview Mode**, you'll be able to see the change ([Documentation](https://www.datocms.com/docs/next-js/setting-up-next-js-preview-mode)).\n\nTo enable the Preview Mode, go to this URL:\n\n```\nhttp://localhost:3000/api/preview?secret=\u003csecret\u003e\n```\n\n- `\u003csecret\u003e` should be the string you entered for `NEXT_EXAMPLE_CMS_DATOCMS_PREVIEW_SECRET`.\n- `\u003cslug\u003e` should be the post's `slug` attribute (you can check on DatoCMS).\n\nYou should now be able to see the updated title. To exit the preview mode, you can click **Click here to exit preview mode** at the top.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fusulpro%2Fdatocms-datocms-sample","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fusulpro%2Fdatocms-datocms-sample","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fusulpro%2Fdatocms-datocms-sample/lists"}