OverVue

<h1 align="center"> <img width="235 height ="235" src="src/assets/ReadMe325x325.svg"> </h1> <p align="center"><b>Prototyping Development Tool for Vue Developers</b></p> <p>OverVue is a prototyping tool that allows developers to dynamically create and visualize a Vue application, implementing a real-time intuitive tree display of component hierarchy and a live-generated code preview. The easy-to-use GUI allows you to add HTML attributes and CSS properties to help the developer envision their next project. The resulting boilerplate code can be exported as a template for further development in your IDE of choice.</p> <hr> <p>这个程序能帮你生成Vue 组件, 设置 routes , 也可以帮你显像Component Parent-Child组件树。你只要做一些小配置然后可以下载code boilerplate. 这样你就可以很方便简洁地生成Vue前台APP了！</p> <hr> <hr>

Table of Contents

• Installation
• How to use OverVue
• Changelogs
• How to contribute
• Authors

Installation

To download the production version, please visit https://www.overvue.org

<hr>

Dev Installation

In your terminal:

1. Install dependencies npm install

2. Build a new .zip / .deb: npm run build (Note: the build may take some time, but should display 'build finished' once it is done and ready to be run)

3. Run electron app in dev mode: npm run dev

<hr>

Updated WSL Installation and Configuration Guide

This section has been updated to reflect the latest advancements with the Windows Subsystem for Linux (WSL), especially focusing on the integration of Linux GUI applications directly within WSL without the need for third-party X server tools like X410 or VcXsrv.

<details> <summary><strong>Expand</strong></summary>

Running Linux GUI Applications in WSL

With the launch of WSLg (Windows Subsystem for Linux GUI), the process of running Linux GUI applications on Windows has been greatly simplified. WSLg integrates directly with WSL 2, offering native support for Linux GUI applications without the necessity for additional display server configurations.

Prerequisites

• Windows 10 version 19044+ or Windows 11.
• WSL 2 installed and set as the default version. Use wsl --install for new installations or wsl --update followed by wsl --shutdown to update and restart WSL.

Configuring Linux GUI Applications

WSLg automatically configures the necessary environment, eliminating the need to manually set display variables for GUI applications. Linux GUI apps can now be launched directly from the Start menu or via the command line, without additional setup.

Legacy Setup Notes (Deprecated)

The previous guidance for setting up X410 or VcXsrv for Linux GUI applications in WSL is now deprecated. While these tools are no longer necessary for the majority of GUI applications in WSL, they remain available for those with specific requirements outside the scope of WSLg's capabilities.

Docker Integration

For Docker containers that require GUI applications, ensure Docker Desktop for Windows is configured to use the WSL 2 backend. This integration with WSLg provides a seamless experience for running GUI-based containers.

Additional Setup for Mac Users (Docker)

Mac users running Linux containers or WSL in a virtualized environment should follow the XQuartz setup for X11 forwarding, applicable only to those operating outside direct WSL integration on Windows.

1. Install XQuartz: brew install --cask xquartz and restart.
2. In XQuartz Preferences > Security, enable "Allow connections from network clients."
3. Allow localhost connections: xhost +localhost.

Common Issues and Solutions

• WSLg not functioning as expected? Verify your Windows version and WSL 2 installation and updates.
• Linux GUI app won't launch? Ensure all components are up to date and the application is compatible with WSLg.

Resources

• WSLg Overview
• Setting up Docker with WSL 2

This guide is designed to help streamline your development environment by utilizing the latest WSL features while minimizing complexity. For more information and detailed troubleshooting, refer to the official WSL documentation.

</details>

How to use OverVue

OverVue kickstarts your project with a default root App component and a "HomeView" route. Here's a quick guide to navigating and utilizing OverVue to its fullest:

1. Creating Components:

   • Enter a name for your new component in the component name box.
   • Select any HTML elements to include within your component. These can be added or nested within each other by dragging and dropping elements in the tree view on the right sidebar or within the component modal (accessible by double-clicking a component node).

2. Organizing Components:

   • Assign a parent component during or after creation to establish your desired hierarchy.
   • Modify your component's structure and relationships anytime by dragging nodes in the tree view. Double-click an HTML element for advanced styling options, including adding attributes like class, ID, and v-model.

This streamlined approach helps you focus on building and visualizing your Vue.js application's component structure efficiently, with intuitive drag-and-drop functionality and easy access to advanced configuration options.

3. Managing State and Actions:

   • Get a live preview of your component's code in the Component Details > Code Preview Tab.

   • Handle routes and associated components using the Routes Tab.

   • Create, edit, and assign state and actions to your components.

• When finished creating, view your code preview under the code preview tab and you can export to a file location of your choice. Below is the exported file structure ('*' = only in typescript format, '**' = only in test format:

public/
src/
  assets/
  components/
    (YourNewComponent1.vue)
    (YourNewComponent2.vue)
    ...
  router/
    index.js/ts
  store/
    index.js/ts
  views/
    HomeView.vue
    (YourNewRoute1.vue)
    (YourNewRoute2.vue)
    ...
  App.vue
  main.js/ts
tests/
  units**
.eslintrc.cjs
env.d.ts*
babel.config.js/ts
jest.config.js/ts**
index.html
package.json
vite.config.js/ts

• To get a better look at the features and how to use OverVue, take a look at the in-app tutorial!

<br/>

↥ Back to top

Changelogs (recent)

<details><summary>OverVue 11.0</summary> <ul> <li>UI redesign and overhaul - focus on accesibility features and increaesd contrast</li> <li> Major update to depenendencies since last version, increasing compatibility between multiplatform OS and re-establishing fix for Windows users </li> <li> Toggle switch from Vue 2 Options API code generation to Vue 3 Compositions API under 'Code Preview' </li> <li> Refactored codebase, clean-up unused old code, unused files for optimization of Electron build </li> <li> Optimize images displayed to take a smaller footprint and increase speeds or older systems </li> <li> Slack and Github OAuth feature has been hidden as currently the feature is not working, and is not seeing much use either </li> <li> Website has been updated with the latest OverVue 11.0 releases for the community to use </li> <br> <h4><strong>Bug Fixes</strong></h4> <li> Fixed Import and Export functionalities </li> <li> Removed unused and outdated dependencies which removed and introduced new bugs (if new bugs are found please mention this in the issues tab) </li> <li> Removed unused files and code to speed up build time</li> <li> Major update to dependencies which greatly sped up speed of application </li> </ul> </details> <details><summary>OverVue 10.0</summary> <ul> <li>Overhauled main view to be an interactive and intuitive tree view</li> <li>Updated HTML Elements list to have nested elements</li> <li>Created a focused component modal</li> <li>Integrated a11y-friendly Vuetensils component library</li> <li>Added unit testing for main tree view feature</li> <li>Refactored codebase, removing unneeded comments, unused files, console logs</li> <li>Cleaned UI of side bars</li> <li>Added previous main grid view to toggle (in top right settings)</li> <br> <h4><strong>Bug Fixes</strong></h4> <li>Fixed HTML elements not live rendering</li> <li>Fixed delete HTML element functionality being inconsistent</li> <li>Fixed Code Preview having unexpecte