next-hono-lucia

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

next-hono-lucia

★ 348 Open GitHub ↗

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

// 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 |

next-hono-lucia

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README