vuegg

vue.js GUI generator

[ Mockups and code in one go! ]

About vuegg

Scaffold vuejs projects by dragging-dropping components directly into the visual editor and moving-resizing them to your choice. Vuegg leverages the creation of the pages and routes of your app/website, eases the styling work and helps to achieve a rapid-prototyping workflow (... at least in theory).

The aim of this project is to merge designing and prototyping into one single process. Whenever you're happy with what you see on the screen, just get your code.

Current Features

Mockup / prototype by drag'n'drop components and move/resize them

Support for standard Mouse and Keyboard combinations

Responsive preview (phone, tablet, web)

Basic set of HTML5 elements

Material design components (vue-mdc-adapter)

Vuejs sources generation (download .zip)

Connect with GitHub (save/load vuegg projects)

Local persistence to save the work in progress

... more to come with time

Keyboard Shortcuts

Select

Mouse down + Drag + Mouse up: Draw a selection area

Ctrl [or Meta] + Click: Select outer-most item, or parent container

Ctrl [or Meta] + Shift + Click: Add [outer-most] item to selection

Esc: Clear selection

Move

Mouse drag & drop: The standard way

ArrowKeys: Moves the selected elements 1px

Shift + ArrowKeys: Moves the selected elements 10px

Copy / Cut / paste

Ctrl [or Meta] + C: Copy selection

Ctrl [or Meta] + X: Cut selection

Ctrl [or Meta] + V: paste selection

Delete

Delete [or Backspace]: Deletes selection

Undo / Redo

Ctrl [or Meta] + Z: Undo last action

Ctrl [or Meta] + Shift + Z: Redo last action

Roadmap

Off the top of my head, I foresee the following features to be developed for the next releases:

Visual feedback when dragging element over droppable container

Grid/layout overlays positioning guides (#14)

Hold shift to maintain aspect ratio on manual resize

Ability to zoom-in / zoom-out in the editor (#24)

Allow the insertion of raw CSS rules (expert mode)

Identify possible risks

Add extra styles controls

BoxShadow

Overflow

TextOverflow

Manage creation/edition of custom components

Transition to custom component (group/ungroup)

Implement custom component editor view

Implement tree navigator to visualize page structure

Run vuegg locally

Auto-run

# install, build and serve

npm run vuegg

Navigate to localhost:5000 to serve (a production-ready) vuegg.

Step-by-step setup

1. installation

# install client & server dependencies

npm run install:all

# OR install only client / server

npm run install:client

npm run install:server

2. development

# serve vuegg-client with hot reload

npm run client

# start vuegg-server (auto-restarts on changes)

npm run server

Navigate to localhost:8080 to serve vuegg-client with hot-reload (development server).

For detailed explanation on how things work on the client side, checkout the

For development vuegg-server will only generate vuejs projects (it won't be serving vuegg-client resources). Auto-restart capabilities possible thanks to

The above commands should be run in separate terminal instances.

3. production

# build vuegg-client for production with minification

npm run build

# start vuegg-server at localhost:5000

npm run start

Navigate to localhost:5000 to serve (a production-ready) vuegg.

Connect with github

Vuegg makes use of .env files to set up some environment variables. The current setup allows you to have 3 files with different configurations: .env, .env.dev and/or .env.test, containing the following variables:

# Create an OAuth App on github and use your client ID and Secret

CLIENT_ID=y0urcl13nt1d

CLIENT_SECRET=y0urcl13nts3cr3t

CALLBACK_URL=http://localhost:8000/auth

This files should exist only on your local machine, do not add them to the git repository.

Now if you wish to test out the connect with github functionality on your local environment, it's necessary to run vuegg-client and vuegg-server through the following command:

npm run oauth

You should be prompted with 3 options to pick. Run server and client in separate terminal instances.

History & current state

The project was born as a sandbox for me to get started on the vue world, in fact its unoriginal name was vuexample (very unique, I thought at the time).

Not long after it became a personal challenge, I went on adding new features (mainly things I feel like learning) and gave it a proper name (and even a face). Eventually I considered it to be ready for the open-source community... and here is vuegg, my pet project.

Contribute

Vuegg is a concept project (and work-in-progress too), feel free to fork it or contribute however possible. You've got a feature idea? Open an issue! Are you up to the task of implementing it? Open a PR!

Help me make vuegg grow!

Donate

Do you like vuegg?