Bem-vindo ao PostIA! Este projeto é uma aplicação web completa, construída com Next.js e Genkit, projetada para atuar como um assistente de marketing de mídia social. Com o poder da IA generativa do Google, o PostIA gera legendas, hashtags relevantes e prompts de imagem detalhados, tudo a partir de um único tópico.
Este README irá guiá-lo para configurar, executar e fazer o deploy do projeto.
- Geração de Conteúdo com um Clique: Insira um tópico e deixe a IA fazer o resto.
- Geração de Legendas, Hashtags e Prompts de Imagem: Um pacote completo de conteúdo para suas postagens.
- Links para Geradores de Imagem: Após gerar um prompt de imagem, o app fornece links diretos para plataformas como o Gemini para você poder criar sua imagem instantaneamente.
- Interface Moderna e Responsiva: Construído com Next.js, React, Tailwind CSS e shadcn/ui.
- Progressive Web App (PWA): O aplicativo pode ser instalado em dispositivos móveis e desktops para uma experiência nativa.
- Monetização com Google AdSense: Preparado para exibir anúncios e gerar receita.
- Framework: Next.js (com App Router)
- Estilização: Tailwind CSS e shadcn/ui
- Inteligência Artificial: Genkit (Google AI)
- Formulários: React Hook Form & Zod
- Ícones: Lucide React
- Linguagem: TypeScript
- Deploy: Vercel
Siga os passos abaixo para ter uma cópia do PostIA rodando em sua máquina.
Para que a IA funcione, você precisa de uma chave de API do Google Gemini.
- Acesse o Google AI Studio.
- Clique em "Get API key" (Obter chave de API) e crie uma nova chave.
- Copie a chave gerada. Você a usará no próximo passo.
-
Clone o repositório:
git clone https://github.com/SEU_USUARIO/PostIA.git cd PostIA -
Instale as dependências:
npm install
-
Crie o arquivo de ambiente: Crie um novo arquivo chamado
.envna raiz do projeto e adicione suas chaves de ambiente:GEMINI_API_KEY=SUA_CHAVE_DE_API_AQUI NEXT_PUBLIC_ADSENSE_CLIENT_ID=ca-pub-SEU_ID_DE_CLIENTE_AQUI
- Substitua
SUA_CHAVE_DE_API_AQUIpela chave que você obteve no Google AI Studio. - Opcional: Substitua
ca-pub-SEU_ID_DE_CLIENTE_AQUIpelo seu ID de cliente do Google AdSense para habilitar os anúncios.
- Substitua
A aplicação Next.js já inclui os fluxos de IA como Server Actions, então você só precisa de um comando para rodar tudo.
npm run devAgora, acesse http://localhost:9002 em seu navegador para ver o PostIA em ação!
Fazer o deploy do PostIA é um processo simples com a Vercel.
- Crie uma conta gratuita na Vercel.
- Faça o upload do seu projeto para um repositório no GitHub, GitLab ou Bitbucket.
- Na Vercel, clique em "Add New..." -> "Project".
- Importe o repositório do seu projeto.
A Vercel detectará automaticamente que é um projeto Next.js e usará as configurações corretas. A única etapa manual é configurar as variáveis de ambiente.
- Dentro das configurações do seu projeto na Vercel, vá para a aba "Settings" -> "Environment Variables".
- Adicione as seguintes variáveis:
GEMINI_API_KEY: Cole a chave de API que você obteve do Google AI Studio. Certifique-se de que a variável não esteja marcada como "Exposed to the client".NEXT_PUBLIC_ADSENSE_CLIENT_ID: (Opcional) Cole o seu ID de Cliente do Google AdSense (ex:ca-pub-123456789...). Como ela começa comNEXT_PUBLIC_, a Vercel a disponibilizará para o cliente automaticamente.
- Salve as variáveis.
- Clique em "Deploy" para publicar sua aplicação com as novas configurações.
A Vercel cuidará de todo o processo de build e deploy. Em poucos minutos, seu PostIA estará online e acessível globalmente!
Para um mergulho profundo em como cada parte do PostIA foi construída, confira nosso documento de workshop! Ele é um tutorial completo que explica o projeto do zero.
➡️ Leia o WORKSHOP.md