Getting help

What Conduit help covers

Conduit is a social blogging site for publishing and discussing articles. Authentication is the sign-in or account-creation part of the application. Use this page when you need project documentation, the live demo, or help with authentication and connection messages.

The project documentation explains how the application works. The live demo is the place to use the application itself. If you need setup, continue with the checklist below.

Before you look for help

Before starting the project, have the required setup and the route that matches your task in front of you.

The application uses the /login and /register routes for these two tasks. For setup questions, continue with the project and demo resources below.

Find project and demo help

Project documentation is the reference for how the project works; the live demo is the place to use Conduit. Use the links below according to the question you need to answer.

1. Choose the row that matches your question and open the linked resource.

Result: You are at the project, demo, or guidance resource that matches your question. If you are using the application, continue with the authentication-screen guidance.

Recognize the authentication screen

The authentication screen lets you enter the application as a user or create an account. The same screen serves both tasks, and its title and fields change with the route.

Prerequisites

• You know whether you are signing in at /login or creating an account at /register.
• You have the email address and password for sign-in, or the username, email address, and password for account creation.

Steps

1. In the unauthenticated header, select the link for your task.

   Task	Select
   Sign in to an existing account	Sign in
   Create an account	Sign up

2. Complete the fields for your task.

   Task	Fields to complete
   Sign in to an existing account	Email and Password
   Create an account	Username, Email, and Password

3. Select Sign in for an existing account or Sign up for a new account.

The sign-in form provides Need an account? to reach registration. The registration form provides Have an account? to return to sign-in.

Result: The selected authentication form is complete and its submit control matches the route: Sign in on /login or Sign up on /register.

Handle authentication and connection problems

An authentication state tells you whether the application is loading, authenticated, unauthenticated, or temporarily unavailable. The header communicates this state while the application checks the session or waits for the server. Error messages appear in a list above the authentication form when a request returns errors. Each server error is rendered as <key> <message>.

1. Find the visible message in the table and follow its corresponding action.

Result: The authentication state is loading, authenticated, or temporarily unavailable, and any visible error message identifies the response that needs attention.

The header shows different links for each state:

When authentication is temporarily unavailable, the application retries after 2, 4, and 8 seconds, then every 16 seconds. A non-/user request that returns 401 purges the authentication state.

For the complete shared message reference, open General error messages.

Choose the next help path

After you identify the task or message, choose the matching help topic below.