📚 Central de Ajuda e Documentação

Tudo o que você precisa saber sobre o Block JS Studio, instalação e solução de problemas.

Voltar para o Início

O Projeto Block JS Studio

O **Block JS Studio** é um editor visual que permite construir aplicações **Web e Desktop** usando blocos gráficos, baseados no Google Blockly. Ele foi projetado para gerar código **Javascript Moderno** (com Async/Await) e **HTML5** limpo.

O foco do editor é o **DOM (Document Object Model)**. Em vez de criar o HTML de forma estática, você usa blocos para **programar a criação** e a **interação** dos elementos da página (Divs, Botões, Imagens), exatamente como em um aplicativo de desktop.

1. Acessando o Terminal

O projeto requer o uso do **Terminal** (ou Linha de Comando) para ser instalado e executado via **Electron**. Veja como acessá-lo em seu sistema:

🪟

Windows (CMD / PowerShell)

Pesquise no menu Iniciar por **"PowerShell"** ou **"Prompt de Comando" (CMD)**. O PowerShell é o mais recomendado. Para comandos de instalação, execute como Administrador.

🍎

macOS (Terminal)

Abra o **"Launchpad"**, vá em **"Outros"** (ou use o Spotlight Search - Cmd + Espaço) e pesquise por **"Terminal"**.

🐧

ChromeOS (Crostini/Linux)

Você deve ter o ambiente Linux (Crostini) configurado. Abra as configurações do ChromeOS, procure por **"Linux"** e clique para abrir a janela do **"Terminal Linux" (Penguin)**.

2. Instalação e Execução

O processo de instalação requer o **Node.js** e a execução de comandos dentro do diretório correto.

1

Descompactar e Acessar a Pasta Correta (Crucial!)

O arquivo que você baixou é um **.zip**. Se você tentar executar comandos nele, o sistema dará erro de "arquivo não encontrado" (por exemplo, package.json) porque o comando só funciona dentro de uma **pasta**.

Ação Obrigatória: Você deve **clicar duas vezes** no arquivo .zip baixado ou usar a opção **"Extrair Tudo"** para transformá-lo em uma pasta comum (ex: meu-projeto-blockjs).

No seu terminal, navegue para **dentro** dessa pasta descompactada com o comando:

cd nome-da-pasta-descompactada
2

Instalar Dependências

Na pasta do projeto, você precisa instalar o Electron e outras dependências que estão listadas no package.json. Rode este comando **apenas na primeira vez** mas primeiro tente rodar npm start, pois o projeto já vem com node_modules instalado:

npm install
3

Iniciar o Projeto

Agora que tudo está instalado, você pode usar o script de atalho que está no package.json para iniciar o Electron.

npm start

Isso executa o comando electron . e abre o editor visual do Block JS.

3. Solução de Problemas Comuns

Problemas de Instalação e Ambiente

❌

npm: command not found

Causa: Você não tem o **Node.js** instalado na sua máquina.

Solução: Baixe e instale a versão recomendada do Node.js em nodejs.org. Reinicie o terminal após a instalação.
❌

Error: Cannot find module 'electron'

Causa: O pacote Electron não foi instalado ou foi instalado em um lugar errado.

Solução 1: Certifique-se de ter rodado npm install **dentro da pasta do projeto**.
Solução 2: Tente instalar globalmente para garantir: npm install -g electron.
❌

Error: No such file or directory, stat 'package.json'

Causa: Você está tentando rodar o comando npm install (ou npm start) na pasta errada (ex: na sua pasta de Downloads ou ainda dentro do arquivo ZIP).

Solução: Volte para a seção **Passo 1** acima. Verifique se você **descompactou** o arquivo .zip e se usou o comando cd para entrar no diretório que contém o arquivo package.json.