Documentação - DevStarter Kit

Instalação

Requisitos do Sistema

PHP: 8.3 ou superior
Composer: Última versão
Node.js: 18.x ou superior
NPM: 8.x ou superior
MySQL: 5.7 ou superior
Servidor Web: Apache/Nginx

Passo a Passo

1. Download e Extração

Após a compra, você receberá um link para download do arquivo ZIP.

# Extrair o arquivo ZIP no diretório do seu servidor
    unzip devstarter-kit.zip
    cd devstarter-kit

2. Instalar Dependências

Instale as dependências do PHP e Node.js:

# Instalar dependências PHP
    composer install

    # Instalar dependências Node.js
    npm install

3. Configurar Ambiente

Configure o arquivo .env com suas credenciais:

# Copiar arquivo de exemplo
    cp .env.example .env

    # Gerar chave da aplicação
    php artisan key:generate

4. Configurar Banco de Dados

Configure as credenciais do banco no arquivo .env:

DB_CONNECTION=mysql
    DB_HOST=127.0.0.1
    DB_PORT=3306
    DB_DATABASE=devstarter_kit
    DB_USERNAME=seu_usuario
    DB_PASSWORD=sua_senha

5. Executar Migrações

Crie as tabelas do banco de dados:

# Executar migrações
    php artisan migrate

    # Executar seeders (dados iniciais)
    php artisan db:seed

6. Compilar Assets

Compile os arquivos CSS e JavaScript:

# Compilar assets para produção
    npm run build

    # Ou para desenvolvimento
    npm run dev

Configuração

Configurações Básicas

Configuração de E-mail

Configure o envio de e-mails no arquivo .env:

MAIL_MAILER=smtp
    MAIL_HOST=smtp.gmail.com
    MAIL_PORT=587
    MAIL_USERNAME=seu_email@gmail.com
    MAIL_PASSWORD=sua_senha_app
    MAIL_ENCRYPTION=tls
    MAIL_FROM_ADDRESS=noreply@seudominio.com
    MAIL_FROM_NAME="DevStarter Kit"

Configuração de Cache

Para melhor performance, configure o cache:

# Limpar cache
    php artisan cache:clear
    php artisan config:clear
    php artisan route:clear
    php artisan view:clear

    # Otimizar para produção
    php artisan config:cache
    php artisan route:cache
    php artisan view:cache

Configuração de Storage

Criar link simbólico para arquivos:

# Criar link simbólico
    php artisan storage:link

Personalização

Alterando Cores

Edite o arquivo tailwind.config.js para personalizar as cores:

module.exports = {
      theme: {
        extend: {
          colors: {
            primary: {
              50: '#fef7ee',
              500: '#f97316',
              600: '#ea580c',
              700: '#c2410c',
            },
            secondary: {
              50: '#f0f9ff',
              500: '#3b82f6',
              600: '#2563eb',
            }
          }
        }
      }
    }

Alterando Logo

Substitua o arquivo public/images/logo.png
Atualize as referências nos templates Blade
Recompile os assets: npm run build

Desenvolvimento

Criando Novas Páginas

1. Criar Controller

php artisan make:controller NomeController

2. Adicionar Rota

// routes/web.php
    Route::get('/minha-pagina', [NomeController::class, 'index']);

3. Criar View

// resources/views/minha-pagina.blade.php

Criando CRUD Completo

# Criar Model, Migration e Controller
    php artisan make:model Produto -mcr

    # Executar migration
    php artisan migrate

    # Criar views
    php artisan make:view produtos.index
    php artisan make:view produtos.create
    php artisan make:view produtos.edit

API

Endpoints Disponíveis

Autenticação

POST /api/login

POST /api/logout

Usuários

GET /api/users

PUT /api/users/{id}

Deploy em Produção

Deploy na Hostinger

Guia completo para fazer deploy do seu sistema Laravel na Hostinger.

1. Preparar o Projeto no GitHub

Primeiro, faça upload do seu projeto para o GitHub:

# Inicializar repositório Git
    git init
    git add .
    git commit -m "Initial commit"
    
    # Conectar ao repositório remoto
    git remote add origin https://github.com/seuusuario/seu-repositorio.git
    git push -u origin main

2. Acessar o Painel da Hostinger

Acesse https://hpanel.hostinger.com/websites
Entre no painel de controle do seu site
No menu, acesse Avançado → SSH
Copie o comando SSH (exemplo: ssh -p 65002 u98565651@185.123.133.132)
Cole no terminal e digite a senha do painel

3. Configurar o Banco de Dados

No painel da Hostinger:

Acesse Gerenciamento de Banco de Dados
Crie um novo usuário e senha para o banco
Anote as credenciais para usar no arquivo .env

4. Configurar o Servidor

Após conectar via SSH, execute os seguintes comandos:

# Navegar para o diretório do domínio
    cd domains
    cd teudominio.com.br
    cd public_html
    
    # Remover arquivo padrão e clonar o projeto
    rm default.php
    git clone https://github.com/seuusuario/seu-repositorio.git .

5. Configurar o .htaccess

Criar arquivo .htaccess na raiz:

# Criar arquivo .htaccess
    touch .htaccess
    nano .htaccess

Adicione o seguinte conteúdo:

<IfModule mod_rewrite.c>
    RewriteEngine On
    
    # Redireciona todas as requisições para o index.php na raiz
    RewriteCond %{REQUEST_URI} !^/public/
    RewriteRule ^(.*)$ public/$1 [L]
</IfModule>

# Proteção contra listagem de diretórios
Options -Indexes

Salve com Ctrl + O e saia com Ctrl + X

6. Configurar o index.php

Editar o arquivo index.php na pasta public:

# Navegar para a pasta public
    cd public
    nano index.php

Substitua todo o conteúdo por:

<?php

use Illuminate\Http\Request;

define('LARAVEL_START', microtime(true));

// Determine if the application is in maintenance mode...
if (file_exists($maintenance = __DIR__.'/../storage/framework/maintenance.php')) {
    require $maintenance;
}

// Register the Composer autoloader...
require __DIR__.'/../vendor/autoload.php';

// Bootstrap Laravel and handle the request...
(require_once __DIR__.'/../bootstrap/app.php')
    ->handleRequest(Request::capture());

7. Instalar Dependências e Configurar

# Voltar para a raiz do projeto
    cd ..
    
    # Instalar dependências PHP
    composer install
    
    # Gerar chave da aplicação
    php artisan key:generate
    
    # Configurar banco de dados
    php artisan migrate:install
    php artisan migrate --force
    php artisan db:seed
    
    # Instalar dependências Node.js
    npm install

8. Compilar Assets

Se encontrar erro de Node.js, execute primeiro:

# Configurar variáveis de ambiente para evitar erro
    export RAYON_NUM_THREADS=1
    export UV_THREADPOOL_SIZE=1
    
    # Compilar assets
    npm run build

9. Configurar .env para Produção

Edite o arquivo .env com as configurações de produção:

APP_ENV=production
    APP_DEBUG=false
    APP_URL=https://seudominio.com
    
    # Configurações do banco de dados
    DB_CONNECTION=mysql
    DB_HOST=localhost
    DB_PORT=3306
    DB_DATABASE=seu_banco
    DB_USERNAME=seu_usuario
    DB_PASSWORD=sua_senha
    
    # Configurações de e-mail
    MAIL_MAILER=smtp
    MAIL_HOST=smtp.gmail.com
    MAIL_PORT=587
    MAIL_USERNAME=seu_email@gmail.com
    MAIL_PASSWORD=sua_senha_app
    MAIL_ENCRYPTION=tls

✅ Deploy Concluído!

Seu sistema Laravel está agora 100% em produção na Hostinger!

Solução de Problemas

Erro 500 - Internal Server Error

Verificar permissões das pastas (755 para diretórios, 644 para arquivos)
Executar: php artisan cache:clear
Verificar arquivo .env
Confirmar se o banco de dados está acessível

Assets não carregam

npm install
    npm run build
    php artisan storage:link

Erro de Permissão

# Definir permissões corretas
    chmod -R 755 storage
    chmod -R 755 bootstrap/cache
    chown -R www-data:www-data storage
    chown -R www-data:www-data bootstrap/cache

📚 Documentação DevStarter Kit

Índice