How to Add a Project — Games & Apps for AYN Thor

Overview

This guide walks you through the process of adding a new project (game or app) to the collection. All contributions are made via GitHub Pull Requests.

Prerequisites

A GitHub account
Git installed on your machine
A text editor (VS Code, Sublime Text, etc.)

Step 1 — Fork the Repository

Navigate to the repository on GitHub.
Click the Fork button in the top-right corner.
A copy of the repository will be created under your GitHub account.

Step 2 — Clone Your Fork

git clone https://github.com/andreyvelsk/GAFT.git
cd GAFT

Step 3 — Create a New Branch

git checkout -b add-<project-slug>

Replace <project-slug> with a short, URL-friendly identifier for your project (e.g. add-my-cool-game).

Step 4 — Create the Content File

Create a new directory under content/ with your project slug and add an index.md file inside it:

content/
└── your-project-slug/
    └── index.md

Template

Copy the template below and fill in the fields:

---
title: "Project Title"
description: "A short one-line description of the project."
date: "YYYY-MM-DD HH:MM"
slug: "your-project-slug"
category: "companion"
media:
  - type: "image"
    url: "https://example.com/screenshot.png"
  - type: "video"
    url: "https://www.youtube.com/watch?v=VIDEO_ID"
tags:
  - tag1
  - tag2
---

## Setup guide

Explain how to install and run the project.

## Tips

- List any useful tips or recommendations.

## Known issues

- Document any known limitations or bugs.

Frontmatter Fields

Field	Required	Description
`title`	✅	Project name displayed as the page heading
`description`	✅	Short description shown on the card and in SEO meta
`date`	✅	Publication date in `YYYY-MM-DD HH:MM` format
`slug`	✅	URL-friendly identifier (must match the directory name)
`category`	✅	One of: `companion`, `app`, `emulation`, `guide`
`media`	❌	List of images or videos for the carousel
`tags`	❌	List of tags for categorization

Media Items

Each media entry supports two types:

Image: type: "image" with a direct URL to the image file
Video: type: "video" with a YouTube URL

Step 5 — Preview Locally (Optional)

Install dependencies and start the dev server:

npm install
npm run dev

Open http://localhost:3000 and navigate to your project page at /project/<your-project-slug>.

Step 6 — Commit and Push

git add .
git commit -m "Add <project title>"
git push origin add-<project-slug>

Step 7 — Open a Pull Request

Go to the original repository on GitHub.
You should see a banner suggesting to create a Pull Request from your recently pushed branch — click Compare & pull request.
Fill in the PR title and description:
- Title: Add <Project Title>
- Description: A brief summary of what the project does and why it fits the collection.
Click Create pull request.

Step 8 — Review

A maintainer will review your PR. You may be asked to make changes. Once approved, the PR will be merged and the project will appear on the site automatically after the next deployment.