{"id":13422702,"url":"https://github.com/tinacms/tina-cloud-starter","last_synced_at":"2025-05-15T10:02:42.852Z","repository":{"id":37850332,"uuid":"329753531","full_name":"tinacms/tina-cloud-starter","owner":"tinacms","description":"Next.js starter for TinaCMS: live edit your website visually  🪄","archived":false,"fork":false,"pushed_at":"2025-04-24T02:34:54.000Z","size":27179,"stargazers_count":249,"open_issues_count":6,"forks_count":383,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-04-24T03:28:41.296Z","etag":null,"topics":["graphql-schema","nextjs","starter-template","tailwindcss","tinacms","vercel"],"latest_commit_sha":null,"homepage":"https://tina-cloud-starter-orcin.vercel.app/","language":"TypeScript","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/tinacms.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}},"created_at":"2021-01-14T22:52:01.000Z","updated_at":"2025-04-18T14:20:36.000Z","dependencies_parsed_at":"2024-04-29T05:29:18.273Z","dependency_job_id":"8f3879c8-5356-4879-8134-53960aaabac3","html_url":"https://github.com/tinacms/tina-cloud-starter","commit_stats":{"total_commits":630,"total_committers":26,"mean_commits":24.23076923076923,"dds":0.7158730158730159,"last_synced_commit":"8c7ec88a9e10c2f086d336aef9ee02864f3f74e9"},"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinacms%2Ftina-cloud-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinacms%2Ftina-cloud-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinacms%2Ftina-cloud-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tinacms%2Ftina-cloud-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tinacms","download_url":"https://codeload.github.com/tinacms/tina-cloud-starter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254319716,"owners_count":22051072,"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":["graphql-schema","nextjs","starter-template","tailwindcss","tinacms","vercel"],"created_at":"2024-07-30T23:00:50.710Z","updated_at":"2025-05-15T10:02:36.740Z","avatar_url":"https://github.com/tinacms.png","language":"TypeScript","funding_links":[],"categories":["Themes","Nextjs Templates","TypeScript","Starter"],"sub_categories":[],"readme":"# Tina Starter 🦙\n\n![tina-cloud-starter-demo](https://user-images.githubusercontent.com/103008/130587027-995ccc45-a852-4f90-b658-13e8e0517339.gif)\n\nThis Next.js starter is powered by [TinaCMS](https://app.tina.io) for you and your team to visually live edit the structured content of your website. ✨\n\nThe content is managed through Markdown and JSON files stored in your GitHub repository, and queried through Tina GraphQL API.\n\n### Features\n\n- [Tina Headless CMS](https://app.tina.io) for authentication, content modeling, visual editing and team management.\n- [Vercel](https://vercel.com) deployment to visually edit your site from the `/admin` route.\n- Local development workflow from the filesystem with a local GraqhQL server.\n\n## Requirements\n\n- Git, [Node.js Active LTS](https://nodejs.org/en/about/releases/), pnpm installed for local development.\n- A [TinaCMS](https://app.tina.io) account for live editing.\n\n## Local Development\n\nInstall the project's dependencies:\n\n\u003e [!NOTE]  \n\u003e [Do you know the best package manager for Node.js?](https://www.ssw.com.au/rules/best-package-manager-for-node/) Using the right package manager can greatly enhance your development workflow. We recommend using pnpm for its speed and efficient handling of dependencies. Learn more about why pnpm might be the best choice for your projects by checking out this rule from SSW.\n\n\n```\npnpm install\n```\n\nRun the project locally:\n\n```\npnpm dev\n```\n\n### Local URLs\n\n- http://localhost:3000 : browse the website\n- http://localhost:3000/admin : connect to Tina Cloud and go in edit mode\n- http://localhost:3000/exit-admin : log out of Tina Cloud\n- http://localhost:4001/altair/ : GraphQL playground to test queries and browse the API documentation\n\n## Deployment\n\n### GitHub Pages\n\nThis starter can be deployed to GitHub Pages. A GitHub Actions workflow is included that handles the build and deployment process. \n\nTo deploy to GitHub Pages:\n\n1. In your repository settings, ensure GitHub Pages is enabled and set to deploy from the `gh-pages` branch\n2. Push changes to your main branch - the workflow will automatically build and deploy the site\n\n\u003e [!NOTE]\n\u003e When deploying to GitHub Pages, you'll need to update your secrets in Settings | Secrets and variables | Actions to include:\n\u003e - `NEXT_PUBLIC_TINA_CLIENT_ID`\n\u003e - `TINA_TOKEN`\n\u003e\n\u003e You get these from your TinaCloud project - [read the docs](https://tina.io/docs/tina-cloud/deployment-options/github-pages)\n\n\u003e [!IMPORTANT]\n\u003e GitHub Pages does not support server side code, so this will run as a static site. If you don't want to deploy to GitHub pages, just delete `.github/workflows/build-and-deploy.yml`\n\n### Building the Starter Locally (Using the hosted content API)\n\nReplace the `.env.example`, with `.env`\n\n```\nNEXT_PUBLIC_TINA_CLIENT_ID=\u003cget this from the project you create at app.tina.io\u003e\nTINA_TOKEN=\u003cget this from the project you create at app.tina.io\u003e\nNEXT_PUBLIC_TINA_BRANCH=\u003cSpecify the branch with Tina configured\u003e\n```\n\nBuild the project:\n\n```bash\npnpm build\n```\n\n## Getting Help\n\nTo get help with any TinaCMS challenges you may have:\n\n- Visit the [documentation](https://tina.io/docs/) to learn about Tina.\n- [Join our Discord](https://discord.gg/zumN63Ybpf) to share feedback.\n- Visit the [community forum](https://community.tinacms.org/) to ask questions.\n- Get support through the chat widget on the TinaCMS Dashboard\n- [Email us](mailto:support@tina.io) to schedule a call with our team and share more about your context and what you're trying to achieve.\n- [Search or open an issue](https://github.com/tinacms/tinacms/issues) if something is not working.\n- Reach out on Twitter at [@tina_cms](https://twitter.com/tina_cms).\n\n## Development tips\n\n### Visual Studio Code GraphQL extension\n\n[Install the GraphQL extension](https://marketplace.visualstudio.com/items?itemName=GraphQL.vscode-graphql) to benefit from type auto-completion.\n\n### Typescript\n\nA good way to ensure your components match the shape of your data is to leverage the auto-generated TypeScript types.\nThese are rebuilt when your `tina` config changes.\n\n## LICENSE\n\nLicensed under the [Apache 2.0 license](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinacms%2Ftina-cloud-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftinacms%2Ftina-cloud-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftinacms%2Ftina-cloud-starter/lists"}