README.md

Tina Starter Alpaca

A starting point for your documentation

✨ Features

• Full integration with TinaCMS

• 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

📝 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
4. 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=***

# 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

5. Install dependencies and run the doc starter:

yarn install
yarn dev

or

npm install
npm run dev

6. Your doc starter should be up and running on http://localhost:3000!

7. If you want the search functionality to work, follow these steps

   1. Make an account at algolia
   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

🔗 Hosting

Deploy it to the cloud with Vercel (Documentation).

You will have to make a new GitHub OAuth App with the url in vercel. You can learn how to do that in our guide..

Issues

If you notice any bugs or have any problems please report them here