Giter VIP home page Giter VIP logo

uxbox's Introduction

License: MPL-2.0 Build Status

UXBOX

UXBOX

Introduction

The open-source solution for design and prototyping. UXBOX is currently at an early development stage but we are working hard to bring you the beta version as soon as possible. Follow the project progress in Twitter or Github and stay tuned!

See SVG specification

SVG based

UXBOX works with SVG, a standard format, for all your designs and prototypes . This means that all your stuff in UXBOX is portable and editable in many other vector tools and easy to use on the web.

Development

Most of the main operations can be done through the helper script manage.sh.

The development requires of UXBOX is done through a single docker container. Each main service is opened in a different tmux sessions.

Docker

Docker is also used to build release images for backend and frontend. Use the helper script manage.sh to build the images. You can run locally UXBOX through a docker-compose or by manually running the containers.

Complementary to the docker images you can build locally from this repository, you can find additionnal flavors for backend and frontend on external repositories:

Persistent data

The UXBOX installation and all data are stored in the database (file uploads, etc). The docker daemon will store that data within the docker directory /var/lib/docker/volumes/.... That means your data is saved even if the container crashes, is stopped or deleted.

To make your data persistent to upgrading and get access for backups is using named docker volume or mount a host folder. To achieve this you need one volume for your database container.

Database:

  • /var/lib/postgresql/data PostgreSQL Data
$ docker run -d \
    -v db:/var/lib/postgresql/data \
    postgresql

You also need to persist the UXBOX backend public resources (media and assets) to not lose images uploaded and allow the frontend to expose assets.

  • /srv/uxbox/resources/public UXBOX backend public resources
$ docker run -d \
    -v db:/srv/uxbox/resources/public \
    monogramm/docker-uxbox-backend

Auto configuration via environment variables

The following environment variables are also honored for configuring your UXBOX instance:

Frontend

Only available at build time!

  • -e UXBOX_API_URL=... (defaults to /api)
  • -e UXBOX_VIEW_URL=... (defaults to /view/)
  • -e UXBOX_DEMO=... (not defined, setting any value will activate demo mode)
  • -e UXBOX_DEBUG=... (not defined, setting any value will activate debug mode)

Available at runtime:

  • -e LANG=... (defaults to en_US.UTF-8)
  • -e LC_ALL=... (defaults to C.UTF-8)

Backend

Available at runtime:

  • -e LANG=... (defaults to en_US.UTF-8)
  • -e LC_ALL=... (defaults to C.UTF-8)
  • -e UXBOX_HTTP_SERVER_PORT=... (defaults to 6060)
  • -e UXBOX_HTTP_SERVER_DEBUG=... (defaults to true)
  • -e UXBOX_DATABASE_USERNAME="..." (defaults to nil)
  • -e UXBOX_DATABASE_PASSWORD="..." (defaults to nil)
  • -e UXBOX_DATABASE_NAME="..." (defaults to "uxbox")
  • -e UXBOX_DATABASE_SERVER="..." (defaults to "localhost")
  • -e UXBOX_DATABASE_PORT=... (defaults to 5432)
  • -e UXBOX_MEDIA_DIRECTORY=... (defaults to resources/public/media)
  • -e UXBOX_MEDIA_URI=... (defaults to http://localhost:6060/media/)
  • -e UXBOX_ASSETS_DIRECTORY=... (defaults to resources/public/static)
  • -e UXBOX_ASSETS_URI=... (defaults to http://localhost:6060/static/)
  • -e UXBOX_EMAIL_REPLY_TO="..." (defaults to [email protected])
  • -e UXBOX_EMAIL_FROM="..." (defaults to [email protected])
  • -e UXBOX_SUPPORT_EMAIL="..." (defaults to [email protected])
  • -e UXBOX_SMTP_HOST="..." (defaults to "localhost")
  • -e UXBOX_SMTP_PORT=... (defaults to 25)
  • -e UXBOX_SMTP_USER="..." (defaults to nil)
  • -e UXBOX_SMTP_PASSWORD="..." (defaults to nil)
  • -e UXBOX_SMTP_SSL=... (defaults to false)
  • -e UXBOX_SMTP_TLS=... (defaults to false)
  • -e UXBOX_SMTP_ENABLED=... (defaults to false)
  • -e UXBOX_REGISTRATION_ENABLED=... (defaults to true)
  • -e UXBOX_SECRET="..." (defaults to "5qjiAndGY3")

Important note: make sure to use quotation marks for string variables or the backend might try to interpret the values as symbols and have weird issues.

Contributing

Open to you!

We love the open source software community. Contributing is our passion and because of this, we'll be glad if you want to participate and improve UXBOX. All your awesome ideas and code are welcome!

Please refer to the Contributing Guide

License

This Source Code Form is subject to the terms of the Mozilla Public
License, v. 2.0. If a copy of the MPL was not distributed with this
file, You can obtain one at http://mozilla.org/MPL/2.0/.

uxbox's People

Contributors

niwinz avatar madmath03 avatar elhombretecla avatar jespino avatar studiospring avatar dependabot[bot] 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.