A starting point for your documentation
-
Full integration with Tina
-
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
- Clone the repo
git clone https://github.com/tinacms/tina-starter-alpaca.git
cd tina-starter-alpaca
- Set up a GitHub OAuth App
- Add a new file called
.env
with the credentials from your Github OAuth App
# OAuth App Credentials from GitHub
GITHUB_CLIENT_ID=************
GITHUB_CLIENT_SECRET=************
SIGNING_KEY=*********
# The path to your repository in GitHub
REPO_FULL_NAME=<GitHub Username>/<Repo 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
- Install dependencies and run the doc starter:
yarn install
yarn dev
npm install
npm run dev
-
Your doc starter should be up and running on http://localhost:3000!
-
If you want the search functionality to work, follow these steps
- Make an account at algolia
- add environment variables to env file (found it the dashboard under the api keys tab)
ALGOLIA_APP_ID=*** ALGOLIA_API_KEY=*** ALGOLIA_ADMIN_KEY=***
- run
yarn create-indices
(this command will have to be run every time you wish to update the indices) - Complete the setup for each index (located on the right side panel)
- Configure searchable attributes (must add excerpt)
- Configure custom ranking (must add excerpt)
- Test and see the search is now working
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 🔔.
- Make a personal GitHub access token 👈 This is the GitHub user that posts any new feedback. Feel free to create a dedicated GitHub account for this.
- Add the following environement variables:
USERNAME_ISSUES=<GitHub username>
GITHUB_ACCESS_TOKEN=<personal access token>
REPO_ISSUES=<repository-name>
Make sure issues are activated in the repository settings.
- Run NextJS in development mode to test:
yarn
yarn dev
- Submit a feedback from the form at the bottom of a documenation page on your site.
- 👀 Check your GitHub repository if an issue has been created.
If you want to use another service (like Formspree) 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
If you notice any bugs or have any problems please report them here