Pronto para Autenticar Seu Novo Projeto

Este Starter Kit foi desenvolvido para poupar seu tempo, oferecendo tudo o que você precisa para começar a desenvolver seu projeto com segurança.

Detalhes Explicados no Meu Canal

Este é um template de projeto de autenticação e autorização implementado em Next.js e create-next-app. Foi incluído a inicialização com Shadcn-ui, prisma Prisma, Authjs | Next-Auth Authjs utilizando banco de dados PostgreSQL

Tecnologias e Bibliotecas

Getting Started

Clone o repositório:

git clone https://github.com/devdeck101/authjs-prisma-template.git

Entre na pasta do projeto e instale os pacotes:

npm install

Banco de Dados

O banco de dados utilizado é o PostgreSQL. Você precisará de uma instância dele para executar o projeto. Um arquivo docker-compose.yml está incluído para facilitar a execução de um container Docker.

Container Docker - Docker Compose

Na raiz do projeto, há um arquivo docker-compose.yml com a configuração para um banco de dados PostgreSQL.

Caso não tenha o docker instalado, pode encontrá-lo aqui Get Docker.

Para inicializar o container:

docker compose up -d

Para finalizar o serviço:

docker compose down postgres

Configuração de Envio de E-Mail

É necessário se cadastrar no RESEND e criar uma chave de API para envios de email, incluindo verificação de usuário, autenticação de dois fatores e mudança de senha.

RESEND API KEY

Após logar na sua conta, siga as instruções na imagem abaixo:

Variáveis de Ambiente

Renomeie o arquivo .env.example para .env. Depois, modifique as variáveis de ambiente conforme necessário:

Váriável do banco de dados:

# Exemplo utilizando o container Docker disponível
DATABASE_URL="postgresql://developerdeck101:developerdeck101@127.0.0.1:5432/test"
# Ou personalize com suas próprias configurações
DATABASE_URL="postgresql://<user>:<password>@<url>:<port>/<db_name>"

Variável de encriptação do token JWT:

AUTH_SECRET=314FUJnJeO1zGfxpxbmqqxQsBiCl/NwOyJ9AONpG03Y=

Para gerar a chave AUTH_SECRET, utilize o comando:

# Unix
openssl rand -base64 32

# Windows
npm exec auth secret

Caso deseje executar em modo produção npm run start, será necessário descomentar a variável:

AUTH_TRUST_HOST=true

Para criar as tabelas do banco de dados, é possível executar os comandos do Prisma ou scripts do projeto.

Tabelas do Banco de Dados

Para criar as tabelas do banco de dados, é possível executar os comandos do Prisma ou scripts do projeto.

Comandos Prisma

Execute o comando:

npx prisma migrate dev

npx prisma db push

Scripts disponíveis

# Cria as tabelas no banco de dados
npm run db:push

# Limpa o banco de dados
npm run db:clear

# Abre o Prisma Studio
npm run db:studio

Para inicializar o projeto

Modo Desenvolvimento

# Executar o Projeto
npm run dev

Modo Produção

# Construir o projeto
npm run build

# Executar o Projeto
npm run start

Abrir http://localhost:3000 com seu navegador.

Configuração de Rotas

A configuração das rotas de middleware é realizada no arquivo de configuração config/routes/index.ts.

import { ConfigRoutes } from "@/types/routes";

export const configRoutes: ConfigRoutes = {
  publicRoutes: [
    "/",
    "/auth/login",
    "/auth/register",
    "/auth/change-password",
    "/auth/reset-password",
    "/auth/verify-email",
  ],
  authRoutes: ["/api/auth/signin"],
  apiRoutes: ["/api/protected-api"],
  protectedRoutes: ["/auth/settings"],
};

Para customizar conforme sua necessidade, utilize a função createRouteMatchers do arquivo lib/route/index.ts dentro do middleware.ts conforme exemplo abaixo:

export default auth((req) => {
  const { isPublicRoute, isProtectedRoute, isApiRoute, isAuthRoute } =
    createRouteMatchers(configRoutes, req);
  const { nextUrl } = req;
  const isLoggedIn = !!req.auth;
  console.log(`Public: ${isPublicRoute}`);
  console.log(`Protected: ${isProtectedRoute}`);
  console.log(`Api: ${isApiRoute}`);
  console.log(`Auth: ${isAuthRoute}`);
  if (isProtectedRoute && !isLoggedIn) {
    return NextResponse.redirect(new URL("/auth/login", req.url));
  }

  // console.log(`Middleware: ${req.nextUrl.pathname}`);
});

Formulário Multi-Step (Fluxo Guiado) 🔥

Foi adicionado a definição para criação de fluxos genéricos guiados de usuário para captura de informações em vários passos e de forma guiada.

O exemplo para criação do Fluxo Guiado esta na pasta abaixo

app\example\multi-step-form

Para aprender como foi desenvolvido nos detalhes, você pode ver o seguinte vídeo onde mostro cada passo do desenvolvimento.

🔥🔥🔥NEXTJS SAAS - DIA 3 - MULTI-STEP-FORM GENÉRICO🔥🔥🔥

Editable Content Compoennt (Compoenent de Conteúdo Editável)

Você pode encontrar o exemplo em app\example\editable-content\page.tsx

"use client";
import { EditableContent } from "@/components/ui/extension/editable-content"

const Page = () => {

    const handleSave = (value: unknown) => {
        console.log(value);
    }
    return (
        <div className="flex flex-col w-full min-h-full items-center justify-center">
            <EditableContent initialValue="Placeholder Text" action={handleSave} />
        </div>
    )
}

export default Page

igorjunio2015/authjs-prisma-template