Gateway and web directory for the Handshake naming system.

This project is supported by the Open Systems Handshake micro grant. Read the initial project proposal.

Developed by: Ryan Moon

---

Why create a directory?

Web directories were used when the internet was first becoming popular to find contact information. These same systems are still used today to find information without the use of search engines.

Finding websites on Handshake is not to difficult thanks to social media and existing websites in the ecosystem. Though having a directory of website listings in one place should help new users find resources faster and see what others are building.

---

Add your website

To add a website to the directory, please make a pull request/issue, email the website details to submit@hns.directory, or fill out the form on the 'Submit site' page.

The process for creating the .md file and making it public can be found on the same Submit site page. This is currently done manually so your website may take some time to be added.

---

Schema

Website details are stored as .md files in the content directory. Only a title, slug, and url are needed for a site to be added, though more information is preferred.

Field Name	Description
title	title of website
slug	url friendly title, same as file name
icon	name of image file, ex: bob.jpg
description	short description of website and services offered
handshake	is the website hosted with handshake, boolean
url	website address, ex: https://hns.ws/
docs	link to documentation
repo	link to git repository
owner	link to where website owner can be reached

---

Setup

Install dependencies, start development server, build application, preview production build:

# npm
npm install
npm run dev
npm run build
npm run preview

Check out the deployment documentation for more information.