Implantação (subdomínio)

Como publicar esta documentação em um subdomínio dedicado.

Visão geral

Esta documentação é um site estático gerado com VitePress. Não depende de PHP ou MySQL — ideal para subdomínio separado, no estilo docs.talktome.com.br.

Subdomínio sugerido: docs.app.growbusiness.com.br

Requisitos

• Node.js 18+
• npm ou pnpm

Desenvolvimento local

cd docs
npm install
npm run dev

Abre em http://localhost:5173

Build de produção

cd docs
npm install
npm run build

Arquivos gerados em docs/.vitepress/dist/

Preview local do build:

npm run preview

Opção 1 — Mesmo servidor (Apache/Nginx)

Nginx

server {
    listen 443 ssl http2;
    server_name docs.app.growbusiness.com.br;

    root /home/appgrowbusinessc/docs/.vitepress/dist;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

    # SSL — use certbot ou certificado existente
}

Apache

<VirtualHost *:443>
    ServerName docs.app.growbusiness.com.br
    DocumentRoot /home/appgrowbusinessc/docs/.vitepress/dist

    <Directory /home/appgrowbusinessc/docs/.vitepress/dist>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    # Fallback SPA
    FallbackResource /index.html
</VirtualHost>

Deploy via rsync/scp

# No servidor de build ou CI
cd docs && npm ci && npm run build

# Enviar dist para o servidor
rsync -avz --delete .vitepress/dist/ user@servidor:/home/appgrowbusinessc/docs/.vitepress/dist/

Opção 2 — Netlify / Vercel

Netlify

1. Conecte o repositório
2. Base directory: docs
3. Build command: npm run build
4. Publish directory: docs/.vitepress/dist
5. Domínio custom: docs.app.growbusiness.com.br

Vercel

Mesma configuração — root docs, output .vitepress/dist.

Opção 3 — GitHub Actions (CI)

Exemplo de workflow:

name: Deploy Docs
on:
  push:
    branches: [main]
    paths: ['docs/**']

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm ci && npm run build
        working-directory: docs
      - name: Deploy via rsync
        run: rsync -avz --delete .vitepress/dist/ ${{ secrets.DEPLOY_USER }}@${{ secrets.DEPLOY_HOST }}:/path/to/docs/
        working-directory: docs

DNS

Crie registro CNAME ou A:

Tipo	Nome	Valor
CNAME	docs.app	seu-host.netlify.app (se Netlify)
A	docs.app	IP do servidor (se VPS)

SSL

Use Let's Encrypt (certbot) no servidor ou SSL automático do Netlify/Vercel.

Atualizar conteúdo

1. Edite arquivos .md em docs/
2. Sidebar: docs/.vitepress/config.mts
3. Tema/cores: docs/.vitepress/theme/custom.css
4. Rebuild e redeploy

Estrutura de pastas

docs/
├── .vitepress/
│   ├── config.mts      # Sidebar, nav, SEO
│   └── theme/
│       ├── index.ts
│       └── custom.css  # Cores Grow (ciano)
├── public/             # Logo, favicon
├── docs/               # Páginas "Plataforma"
├── pmo/
├── comercial/
├── aprova-grow/
├── clientes/
├── equipe/
├── comunicacao/
├── configuracoes/
├── faq.md
├── deploy.md
└── index.md            # Home

Link no painel PMO

Opcional: adicione link Documentação no menu ou footer apontando para:

https://docs.app.growbusiness.com.br

Próximo passo

Volte ao Início rápido ou explore a sidebar.