hns.ws/README.md

2.6 KiB

HNS↗WS

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.