next-hono-lucia - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #machine-learning #rust #deep-learning #docker #java #cli #kubernetes #awesome-list #vue #pytorch #security #mcp

next-hono-lucia

(★ 348)

A Next.js (v15) template that uses Hono as the API framework and Lucia for authentication.

File Explorer

Download Latest Version (.zip)

- extensions.json
- settings.json
- .gitkeep
- - client-user.tsx
  - layout.tsx
  - not-found.tsx
  - page.tsx
- - app-sidebar.tsx
  - auth-provider.tsx
  - logout.tsx
  - nav-main.tsx
  - nav-projects.tsx
  - nav-user.tsx
  - providers.tsx
  - team-switcher.tsx
  - theme-toggle.tsx
- - confirmation-code.tsx
- - client.ts
  - server.ts
- - use-mobile.tsx
- - routes.ts
  - utils.server.tsx
  - utils.ts
- - auth.ts
- - actions.ts
  - client.ts
  - error.ts
  - index.ts
  - types.ts
- - auth.ts
- - globals.css
.dockerignore
.env
.eslintrc.js
.gitignore
.prettierrc.js
CODE_OF_CONDUCT.md
components.json
custom.d.ts
Dockerfile
drizzle.config.ts
LICENSE
next-env.d.ts
next.config.ts
package.json
pnpm-lock.yaml
postcss.config.js
README.md
reset.d.ts
tailwind.config.ts
tsconfig.json
tsconfig.tsbuildinfo

# Installation Guide

1. Get the code

git clone https://github.com/TheBinaryGuy/next-hono-lucia

Downloads the entire project code from GitHub to your computer.

cd next-hono-lucia

Moves into the project folder you just downloaded.

2. Docker

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Docker Desktop Needed to build and run containers. Install it and keep it running in the background.

docker build -t next-hono-lucia .

Builds a runnable image based on the Dockerfile.

docker run -p 8080:80 next-hono-lucia

Runs the built image as an actual container.

✅ Run docker compose ps to check the containers are Up. If the README mentions a port, open http://localhost:PORT in your browser.

3. Node.js

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Node.js Node.js must be installed to use npm. The LTS version is recommended.

pnpm create next-app your-app-name -e https://github.com/TheBinaryGuy/next-hono-lucia

Type this command into your terminal and run it.

pnpm db:migrate

Type this command into your terminal and run it.

pnpm dev

Starts the development/run server.

✅ After running the command, open the address shown in the terminal (usually something like http://localhost:3000) in your browser.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Hono x Lucia

This is a Next.js template that uses Hono as the API framework and Lucia for authentication. This also uses hono's Zod to OpenAPI package to generate OpenAPI schema available at `/api/swagger.json` and the editor / playground at `/api/scalar`.

Uses:

-   [Tailwind CSS](https://tailwindcss.com/) for styling
-   [Shadcn](https://ui.shadcn.com/), [Radix](https://www.radix-ui.com/), [input-otp](https://input-otp.rodz.dev/), [Sonner](https://sonner.emilkowal.ski/), etc. for the UI components
-   [Hono](https://hono.dev/) as the API framework
-   [Scalar](https://docs.scalar.com/swagger-editor) as the Swagger Editor
-   [Drizzle](https://orm.drizzle.team/) as the ORM
-   [Postgres](https://www.postgresql.org/) as the database
-   [Lucia](https://lucia-auth.com/) and [Oslo](https://oslo.js.org/) for auth
-   [React Email](https://react.email/) for the email templates

## Getting Started (Development Environment)

-   Clone this template using:

```bash
pnpm create next-app your-app-name -e https://github.com/TheBinaryGuy/next-hono-lucia
```

-   Create a database on your local postgres instance called `example`.
-   Then run the following commands:

```bash
cd your-app-name
pnpm db:migrate
pnpm dev
```

-   That's it!

## Environment Variables

| Name               | Description                                                                                                                                |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| NEXT_PUBLIC_DOMAIN | The domain of the website, defaults to localhost:3000                                                                                      |
| DATABASE_URL       | Postgres connection string, defaults to postgres://postgres@localhost/example                                                              |
| EMAIL_FROM         | Email from address, defaults to "Example <hey@example.com>"                                                                                |
| EMAIL_PROVIDER     | Email provider, console, smtp, resend, default is console                                                                                  |
| RESEND_API_KEY     | If email provider is resend, get your key from resend.com                                                                                  |
| SMTP_HOST          | If email provider is smtp                                                                                                                  |
| SMTP_PORT          | If email provider is smtp, defaults to 587                                                                                                 |
| SMTP_USERNAME      | If email provider is smtp                                                                                                                  |
| SMTP_PASSWORD      | If email provider is smtp                                                                                                                  |
| SMTP_SECURE        | If email provider is smtp, true or 1, defaults to true                                                                                     |
| STANDALONE         | If you want standalone output, set this to 1, if you are using the provided `Dockerfile` then this is already taken care of, defaults to 0 |