Map Blueprint

Rode o Map Blueprint no seu próprio computador

Coloque o app para funcionar no seu próprio computador em apenas alguns minutos, perfeito para uma pessoa só ou uma equipe na mesma rede. Não há nada para instalar e nenhum arquivo para editar: o Map Blueprint é um único programa que você baixa e abre com dois cliques, como qualquer outro app.

Antes de começar: descompacte o arquivo que você baixou onde preferir (por exemplo, uma nova pasta MapBlueprint dentro dos seus Documentos). Lá dentro você vai encontrar um programa para cada tipo de computador, use o que combina com o seu (Windows, Mac ou Linux) e ignore os outros. Quer que colegas de outros lugares acessem pela internet? Use o guia de hospedagem em nuvem.
O que realmente acontece quando você executa? Duas coisas começam juntas: um pequeno programa em segundo plano (chamado servidor) que armazena seus mapas e permite que as pessoas se conectem, e o seu navegador, que abre o app. Enquanto o servidor estiver rodando, o app funciona. Fechá-lo para o app, seus mapas salvos continuam seguros no seu disco.

Windows

1. Inicie o app

Dê dois cliques em MapBlueprint.exe. Uma pequena janela de console preta abre, é o servidor fazendo seu trabalho, então é só deixá-la aberta. O seu navegador então abre o app automaticamente.

Na primeira vez, o Windows pode mostrar uma caixa azul "O Windows protegeu o seu PC" porque o app não é de uma editora famosa. Clique em Mais informações → Executar assim mesmo. Isso é normal para apps indie pequenos e é seguro, o app apenas não tem assinatura de código, só isso.

2. Defina uma senha

Na primeiríssima execução você verá uma rápida tela de Configuração. Escolha uma senha que sua equipe vai usar para entrar (ou deixe em branco se este for um computador privado só seu) e clique em Salvar, é toda a configuração.

3. Comece a mapear

Você cairá no seu painel de Mapas. Crie um mapa e compartilhe o link dele com os colegas na sua rede. Para parar o app depois, feche a janela de console; para iniciá-lo de novo, dê dois cliques no programa.

Mac

MapBlueprint-mac roda em todo Mac, tanto Apple Silicon (M1/M2/M3/M4) quanto Macs Intel mais antigos. No Apple Silicon, o macOS pode oferecer a instalação do Rosetta na primeira vez, clique em Instalar (é um componente da Apple, com um clique, que permite o app rodar).

1. Abra pela primeira vez

O macOS bloqueia apps que não vieram da App Store na primeira vez que você abre um deles. Para passar por isso uma vez: clique com o botão direito (ou segure Control e clique) no programa → Abrir → Abrir de novo na caixa de diálogo. Depois dessa primeira vez você pode só dar dois cliques nele como em qualquer app.

À vontade com o Terminal (o app de comandos de texto do Mac)? Você pode fazer a mesma coisa rodando as três linhas abaixo a partir da pasta que contém o programa. A primeira limpa a marca de "baixado da internet", a segunda marca o arquivo como executável e a terceira o inicia:

xattr -d com.apple.quarantine ./MapBlueprint-mac
chmod +x ./MapBlueprint-mac
./MapBlueprint-mac

2. Defina uma senha e comece a mapear

Seu navegador abre a tela de Configuração da primeira execução. Escolha uma senha (ou deixe em branco) e salve, você já está mapeando. Um arquivo de configurações (config.json) e seus mapas são criados bem ao lado do programa.

Linux desktop

Abra um terminal na pasta que contém o programa. O primeiro comando marca o arquivo como executável; o segundo o inicia. Seu navegador então abre a tela de Configuração.

chmod +x ./map-blueprint-linux
./map-blueprint-linux

Quer um servidor Linux sempre ligado que colegas remotos possam acessar? Siga o guia de hospedagem em nuvem.

Altere as configurações quando quiser

Abra o app, vá para a sua página de Mapas e clique em Configurações. A partir daí você pode alterar o nome, as cores, o logo, a senha, a porta e o tamanho da equipe, sem arquivos para editar. Mudanças de aparência aparecem na próxima atualização da página; mudanças de senha e de porta entram em vigor depois que você reinicia o programa.

Deixar a senha em branco roda uma instância aberta, sem login. Só faça isso em uma rede privada em que você confie e controle.

Seus dados e backups

Compartilhe na sua rede local

Para deixar colegas na mesma rede Wi-Fi ou do escritório abrirem seus mapas, você primeiro diz ao app para aceitar conexões de outros computadores, por padrão ele só escuta o seu. Abra Configurações, defina o endereço de bind como 0.0.0.0 (em bom português: "aceitar conexões de qualquer computador na minha rede") e reinicie o programa. Os colegas então acessam você em http://YOUR-COMPUTER-IP:8080.

Para descobrir o endereço IP local do seu computador (um número como 192.168.1.42), rode um destes em um terminal:

Defina uma senha em Configurações primeiro, caso contrário, qualquer pessoa na rede com o link pode abrir seus mapas.

Deixe colegas remotos entrarem, um túnel gratuito

Quer que pessoas fora da sua rede acessem o app enquanto ele continua rodando no seu próprio computador? Um túnel é um pequeno auxiliar que dá ao seu app um endereço web público https://…, sem mudanças no roteador, criptografado e gratuito. O mais fácil é um Cloudflare Tunnel.

Defina uma senha primeiro. Abra Configurações e escolha uma senha forte antes de abrir o túnel, assim que ele estiver no ar, qualquer pessoa com o link pode acessar o app.

1. Instale o cloudflared

cloudflared é a ferramenta de túnel gratuita da Cloudflare. Você a instala uma vez:

2. Inicie o Map Blueprint

Rode o app como de costume e deixe-o aberto, ele está escutando em http://localhost:8080 (localhost significa só "este computador"). Você pode deixar o endereço de bind no padrão; o túnel acessa o app aqui mesmo na sua máquina.

3. Abra o túnel

Abra uma nova janela de terminal ou PowerShell (mantenha o app rodando na janela dele) e rode:

cloudflared tunnel --url http://localhost:8080

Depois de um instante, ele imprime um endereço público como https://random-words.trycloudflare.com. Compartilhe esse link, os colegas o abrem de qualquer lugar, entram com a sua senha e editam ao vivo com você. Mantenha as duas janelas abertas (o app e o túnel); fechar a janela do túnel para o compartilhamento.

Esse túnel rápido não precisa de nenhuma conta Cloudflare, mas o endereço muda toda vez que você o reinicia. Para um endereço permanente no seu próprio domínio, crie uma conta Cloudflare gratuita e configure um túnel nomeado, o guia de hospedagem em nuvem mostra a mesma configuração do cloudflared, e ela funciona do mesmo jeito apontando para o seu PC local. Para uma instância sempre no ar, mesmo com o seu computador desligado, rode-a em um pequeno servidor em nuvem.