GithubHelp home page GithubHelp logo

idjhuang / structor Goto Github PK

View Code? Open in Web Editor NEW

This project forked from ricky0604/structor

0.0 1.0 0.0 6.07 MB

User interface builder for React

License: GNU General Public License v3.0

JavaScript 96.75% CSS 3.07% HTML 0.18%

structor's Introduction

Structor - a user interface builder for React

Join the chat at https://gitter.im/ipselon/structor npm version npm downloads structor channel on discord

Short presentation

Watch the presentation about how Structor works. This presentation shows all capabilities of Structor as development tool and describe its user interface controls: How does Structor work ?

Video

Description

Structor is a visual development environment for node.js Web applications with React UI.

The essential part of the builder is a project boilerplate. The boilerplate is a prepacked source code of node.js application in which metainfo included. Using this info Structor knows how to use components included into the package. There is a place where you can find and download boilerplates - a Structor Market http://helmetrex.com.

It absolutely doesn't mean that you has to strictly follow the rules by which the boilerplate was designed and change the development process you used to follow. Each project is completely hackable and you can change almost everything. For example, if you don't want to use Redux or React Bootstrap in the project you may remove them from the source code. The builder is only the environment which uses metadata of the project to provide UI building.

More about the structure of pre-pack and how it is used by Structor please read Wiki of the project bootstrap-prepack.

The builder runs as HTTP server with webpack-dev-middleware + webpack-hot-middleware + react-transform-hmr inside. So, the builder can be used as an HTTP server with all hot reloading capabilities from the box.

Switching between two modes: edit mode and live-preview mode gives a feeling as if you are creating the Web app right in the browser. And of course, you can edit the source code in your favorite IDE or text editor and don't worry about page reloading (maybe in rear cases).

Apparently, we can admit that this tool having such features can be used not only in starter prototyping phase of development process, but used during all development process instead of HTTP backend server for Web app.

Documentation

Tutorials

Getting started

Install Structor in global scope:

npm install structor -g

Then you have two ways to start working in the builder.

The first way:

  • Create an empty folder on local machine.
  • cd to this folder and run command: structor.
  • Open the browser and enter the address: http://localhost:2222/structor.
  • Choose suitable prepack and click clone option.
  • Start composing UI...

The second way:

  • Go to Structor Market http://helmetrex.com, choose suitable boilerplate.
  • Download package on localhost and unpack it in some empty folder.
  • cd to this folder and run npm install command.
  • Once installation is finished run structor.
  • Open the browser and enter the address: http://localhost:2222/structor.
  • Start composing UI...

The next time you want to open project in Structor, just go to the folder where project is and run structor.

Tips

To run with different port: structor -p <port>
To specify different project's working directory: structor -d <path_to_project_dir>

How to add own boilerplate to Srtuctor Market

The source code of all boilerplates wich are presented on Structor Market are located on GitHub. Consequently, you can add to the market the reference of your own Structor compatible boilerplate which exists on GitHub. To do that you have to visit Structor Market and enter the name of repository into add form.

The source code has to be compatible with Structor, to see examples of compatible repositories just visit any of already presented boilerplates. Also please note, in order to have a good looking thumbnail of your project on the market add 'screenshot.png' file with screen shot of the Structor's workspace with your project open.

Or if you know repositoires of Structor compatible repos not presented on the market, please add it to the market's gallery. We appreciate your contribution to the market.

Discussion

You are welcome to join Discord channel: #structor

License

GNU GENERAL PUBLIC LICENSE Version 3 (GPL-3.0)

structor's People

Contributors

ipselon avatar gitter-badger avatar allan-simon avatar hhravn avatar

Watchers

James Huang avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.