Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tinacms/tina-starter-alpaca
NextJS Documentation starter powered by TinaCMS
https://github.com/tinacms/tina-starter-alpaca
nextjs-starter tina vercel
Last synced: 3 months ago
JSON representation
NextJS Documentation starter powered by TinaCMS
- Host: GitHub
- URL: https://github.com/tinacms/tina-starter-alpaca
- Owner: tinacms
- Archived: true
- Created: 2020-03-25T15:59:14.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-12-09T01:38:20.000Z (almost 3 years ago)
- Last Synced: 2024-06-25T12:44:21.764Z (5 months ago)
- Topics: nextjs-starter, tina, vercel
- Language: JavaScript
- Homepage: https://tina-starter-alpaca.now.sh
- Size: 4.65 MB
- Stars: 55
- Watchers: 14
- Forks: 54
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 
Tina Starter Alpaca
> A starting point for your documentation
## :sparkles: Features
- Full integration with [Tina](https://tina.io)
- Edit and add new documentation pages
- Fully customizable Navigation
- Organized your documentation into groups and subgroups
- Change order of or the navigation
- Theme Customization
- Colors
- Fonts
- Titles
## :memo: Getting started on localhost
1. Clone the repo `git clone https://github.com/tinacms/tina-starter-alpaca.git`
2. `cd tina-starter-alpaca`
3. [Set up a GitHub OAuth App](https://tina.io/guides/nextjs/github-open-authoring/github-oauth-app)
4. Add a new file called `.env` with the credentials from your Github OAuth App
```env
# OAuth App Credentials from GitHub
GITHUB_CLIENT_ID=************
GITHUB_CLIENT_SECRET=************
SIGNING_KEY=*********
# The path to your repository in GitHub
REPO_FULL_NAME=/
# The base branch that new changes and forks are created from. Defaults to 'master'.
BASE_BRANCH=master
```
You can learn more about [Open Authoring With Github in our guide](https://tina.io/guides/nextjs/github-open-authoring/initial-setup)
5. Install dependencies and run the doc starter:
```bash
yarn install
yarn dev
```
#### or
```bash
npm install
npm run dev
```
6. Your doc starter should be up and running on [http://localhost:3000](http://localhost:3000)!
7. If you want the search functionality to work, follow these steps
1. Make an account at [algolia](https://www.algolia.com/)
2. add environment variables to env file (found it the dashboard under the api keys tab)
```
ALGOLIA_APP_ID=***
ALGOLIA_API_KEY=***
ALGOLIA_ADMIN_KEY=***
```
3. run `yarn create-indices` (this command will have to be run every time you wish to update the indices)
4. Complete the setup for each index (located on the right side panel)
1. Configure searchable attributes (must add excerpt)
2. Configure custom ranking (must add excerpt)
5. Test and see the search is now working
## Deploy on Vercel
## Gathering Feedback with Github
People can submit feedback from any documentation page. This feedback is immediately posted to GitHub and stored as issues to the repository of your choosing.
GitHub issues are an awesome way to store feeback, make it searchable, filterable on page URL or reaction types for instance, and you can choose to be notified of any new comment on your website 🔔.
### Setup
1. [Make a personal GitHub access token](https://docs.github.com/en/github/authenticating-to-github/creating-a-personal-access-token) 👈 This is the GitHub user that posts any new feedback. Feel free to create a dedicated GitHub account for this.
2. Add the following environement variables:
```env
USERNAME_ISSUES=
GITHUB_ACCESS_TOKEN=
REPO_ISSUES=
```
Make sure issues are activated in the repository settings.
3. Run NextJS in development mode to test:
```bash
yarn
yarn dev
```
4. Submit a feedback from the form at the bottom of a documenation page on your site.
5. 👀 Check your GitHub repository if an issue has been created.
## Gathering Feedback with another endpoint
If you want to use another service ([like Formspree](https://formspree.io/)) you can change the endpoint that the form is send to. Simple add the following line to your `.env` file
```
FEEDBACK_ENDPOINT=https://example.com
```
## :link: Hosting
[](https://vercel.com/import/project?template=https%3A%2F%2Fgithub.com%2Ftinacms%2Ftina-starter-alpaca%2F&env=REPO_FULL_NAME,GITHUB_CLIENT_ID,GITHUB_CLIENT_SECRET,SIGNING_KEY&envDescription=GitHub%20OAuth%20needed%20for%20TinaCMS&envLink=https%3A%2F%2Ftina.io%2Fguides%2Fnextjs%2Fgithub%2Fhosting-vercel&project-name=tinacms-next-documentation&repo-name=tinacms-next-documentation)
- [See how to deploy NextJS on Vercel](https://nextjs.org/docs/deployment).
- [You have to **create a GitHub OAuth App** with your Vercel URL](https://tina.io/guides/nextjs/github-open-authoring/hosting-vercel).
## :octocat: Issues
If you notice any bugs or have any problems please [report them here](https://github.com/tinacms/tina-starter-alpaca/issues/new)