ResidentialSketch — Design Elétrico Residencial na Web
javascriptcanvasengineeringelectricalweb-app

ResidentialSketch — Design Elétrico Residencial na Web

Uma ferramenta profissional para desenho de circuitos elétricos residenciais, com simulação em tempo real, integração em nuvem e alta precisão.

4 min de leitura

O ResidentialSketch nasceu de uma necessidade técnica clara: como tornar o design de circuitos elétricos residenciais algo acessível, preciso e totalmente baseado na web?

Diferente de ferramentas de CAD genéricas, o ResidentialSketch foi projetado especificamente para eletricistas e engenheiros que precisam de agilidade sem abrir mão do rigor técnico.

Precisão no Canvas

O coração do projeto é um motor de renderização customizado usando a Canvas API. Não se trata apenas de desenhar linhas; cada elemento — tomadas, interruptores, fiação, quadros de distribuição — é um objeto lógico com coordenadas precisas e detecção de colisão (hit detection) ao nível de pixel.

Isso permite que o usuário interaja com o projeto de forma fluida:

  • Seleção precisa de componentes pequenos.
  • Ferramentas de medição em tempo real.
  • Snapping inteligente para alinhamento automático.

Integração em Nuvem e Colaboração

Um dos maiores desafios foi a persistência de dados. Implementamos um sistema de CloudSave e CloudOpen usando o Supabase. Isso permite que o usuário:

  1. Salve projetos com nomes personalizados.
  2. Acesse sua biblioteca de projetos de qualquer dispositivo.
  3. Carregue versões anteriores com um seletor visual intuitivo.

A autenticação é integrada de forma transparente, garantindo que cada usuário tenha seu próprio workspace seguro.

UX: Aprendizado Guiado

Sabemos que ferramentas técnicas podem ter uma curva de aprendizado íngreme. Por isso, desenvolvemos um TutorialManager interativo. Ao abrir o software pela primeira vez, o usuário é guiado por uma série de passos práticos que ensinam desde a navegação básica até a exportação final do projeto.

O design visual segue princípios de minimalismo moderno, com uma hierarquia clara e feedback visual imediato para cada ação do usuário.

Desafios Técnicos e Evolução

O projeto passou por refatorações profundas para garantir performance. Migramos de uma estrutura dependente de módulos complexos para um padrão de carregamento global mais eficiente, otimizando o tempo de boot da aplicação.

Também investimos pesado em acessibilidade visual, garantindo que o contraste e a tipografia facilitem a leitura de diagramas técnicos complexos mesmo em telas menores.

Conclusão

O ResidentialSketch é mais do que um "Paint para circuitos". É um experimento de engenharia de software que prova que a web moderna é capaz de hospedar ferramentas de design complexas com performance de desktop.

O projeto continua evoluindo, com planos para simulação de carga em tempo real e geração automática de lista de materiais.


Tech Stack

  • Frontend: Vanilla JavaScript (ES6+), HTML5 Canvas, CSS Modules.
  • Backend: Supabase (Auth, Database, Storage).
  • Tooling: Vite para desenvolvimento e build.

The ResidentialSketch was born from a clear technical need: how to make residential electrical circuit design accessible, precise, and entirely web-based?

Unlike generic CAD tools, ResidentialSketch was designed specifically for electricians and engineers who need speed without sacrificing technical rigor.

Precision on the Canvas

The heart of the project is a custom rendering engine using the Canvas API. It's not just about drawing lines; every element — outlets, switches, wiring, distribution boards — is a logical object with precise coordinates and pixel-level hit detection.

This allows the user to interact with the project fluidly:

  • Precise selection of small components.
  • Real-time measurement tools.
  • Intelligent snapping for automatic alignment.

Cloud Integration and Collaboration

One of the biggest challenges was data persistence. We implemented a CloudSave and CloudOpen system using Supabase. This allows the user to:

  1. Save projects with custom names.
  2. Access their project library from any device.
  3. Load previous versions with an intuitive visual picker.

Authentication is seamlessly integrated, ensuring each user has their own secure workspace.

UX: Guided Learning

We know that technical tools can have a steep learning curve. That's why we developed an interactive TutorialManager. When opening the software for the first time, the user is guided through a series of practical steps that teach everything from basic navigation to the final project export.

The visual design follows modern minimalism principles, with a clear hierarchy and immediate visual feedback for every user action.

Technical Challenges and Evolution

The project underwent deep refactorings to ensure performance. We migrated from a structure dependent on complex modules to a more efficient global loading pattern, optimizing the application's boot time.

We also invested heavily in visual accessibility, ensuring that contrast and typography make it easy to read complex technical diagrams even on smaller screens.

Conclusion

ResidentialSketch is more than just a "Paint for circuits." It's a software engineering experiment that proves the modern web is capable of hosting complex design tools with desktop-like performance.

The project continues to evolve, with plans for real-time load simulation and automatic material list generation.