# Quick Start

This document is a step-by-step guide for basically setting up Hitchy (opens new window) with support for authentication and authorization using this plugin.

# Setup Project

Create a folder for your application and enter it:

mkdir my-new-app
cd my-new-app

Initialize your application's package management so dependencies are tracked:

npm init -y

Install @hitchy/core (opens new window) and @hitchy/plugin-auth (opens new window) as dependencies:

npm install @hitchy/core @hitchy/plugin-auth

# Start Hitchy

At this point Hitchy is ready. Thus, start it with:

hitchy start

Hitchy not found?

If Hitchy isn't found this might be due to issues with your Node.js and npm setup. In most cases using npx solves this issue for now:

npx hitchy start

Keep it running while trying out next.


Whenever you want to stop Hitchy press Ctrl+C to gracefully shut it down.

# Try It Out

The plugin injects special endpoints for managing a user's authentication by default. You should be able to authenticate with a request like this:

POST /api/auth/login HTTP/1.0
Content-Type: application/x-www-form-urlencoded


This works due to the default configuration for implicitly setting up administrator account on application start.