Home

Awesome

<h1 align="center"> StackBox </h1> <p align="center"> <a href="https://github.com/Stack-Box/stackbox/actions?query=workflow%3AVue" alt="Vue"> <img src="https://github.com/Stack-Box/stackBox/workflows/Vue/badge.svg" /></a> <a href="https://github.com/Stack-Box/stackbox/actions?query=workflow%3AAngular" alt="Angular"> <img src="https://github.com/Stack-Box/stackBox/workflows/Angular/badge.svg" /></a> <a href="https://github.com/Stack-Box/stackbox/actions?query=workflow%3AReact" alt="React"> <img src="https://github.com/Stack-Box/stackBox/workflows/React/badge.svg" /></a> <a href="https://github.com/Stack-Box/stackbox/actions?query=workflow%3AFlask" alt="Flask"> <img src="https://github.com/Stack-Box/stackBox/workflows/Flask/badge.svg" /></a> <a href="https://github.com/Stack-Box/stackbox/actions?query=workflow%3ARails" alt="Rails"> <img src="https://github.com/Stack-Box/stackbox/workflows/Rails/badge.svg" /></a> <a href="https://github.com/Stack-Box/stackbox/actions?query=workflow%3AGolang" alt="Golang"> <img src="https://github.com/Stack-Box/stackbox/workflows/Golang/badge.svg" /></a> </p> <p align="center"> <a href="https://github.com/Stack-Box/stackbox/issues" alt="Contributions"> <img src="https://img.shields.io/badge/contributions-welcome-blue.svg?style=flat" /></a> <a href="https://github.com/Stack-Box/stackbox/labels/good%20first%20issue" alt="Good First Issue"> <img src="https://img.shields.io/github/issues/Stack-Box/stackbox/good%20first%20issue" /></a> </a> <a href="https://join.slack.com/t/stackboxworkspace/shared_invite/zt-e5ye1rsg-fLJLy2NeTe6s1nG_3yKU_Q" alt="Slack"> <img src="https://img.shields.io/badge/slack-chat-purple.svg?logo=slack" /></a> </p> <br/>

Stackbox helps you create app stacks loaded with all your favourite clients, services and infra in under 5 mins. The aim of the project is to help developers setup quick infra and boilerplates to start the dev work asap. Ideally this project is to help rapid prototyping, building PoCs or writing code for hackathons.

Wiki is a good place to start!

  1. About
  2. Get Started
  3. Working
  4. Debugging

Get Started

Run

Brew installation

brew tap Stack-Box/tap
brew install stackbox

Run

stackbox

Creates a folder names stackbox in the current directory with all source.

From source

sh stackbox.sh

Follow the menu options to select clients and services for your stack.

Jump to example-stacks to quickly try a run

Support

Clients/ServicesMysqlElasticsearchMongoDBS3DynamoDB
Flask
Rails
Vue
Angular
React

Other containers that you can bring up:

  1. nginx
  2. kibana
  3. kafka + zookeeper (there's a kafka handler support for put/get messages in flask)

Example Stacks

The following are a few example stacks you could spin-up.

Run from source - sh stackbox.sh or Run from Brew installation - stackbox

1. Flask-Vue-Mysql-Elasticsearch

Choose vue for frontend, flask for backend. Choose mysql and elasticsearch (with/without kibana) for services. After the run is finished, the final log should look like the one below.

flask is up at http://localhost:80
vue is up at http://localhost:8080
elasticsearch is up at http://localhost:9200
mysql is up at http://localhost:3306

Now you can visit http://localhost:8080 to view the Vue frontend. From there you can click on Mysql/Elasticsearch links to view the preloaded data from mysql/elasticsearch containers being rendered.

<p align="center"> <a href="https://drive.google.com/uc?export=view&id=1jhCdbpN_RqvtxHeL5fUSRNJFIF9s51WW"> <img src="https://drive.google.com/uc?export=view&id=1jhCdbpN_RqvtxHeL5fUSRNJFIF9s51WW"/> </a> </p>

2. Flask-Angular-Mysql-Elasticsearch

Choose vue for frontend, flask for backend. Choose mysql and elasticsearch (with/without kibana) for services. After the run is finished, the final log should look like the one below.

flask is up at http://localhost:80
angular is up at http://localhost:4200
elasticsearch is up at http://localhost:9200
mysql is up at http://localhost:3306

Now you can visit http://localhost:4200 to view the Vue frontend. From there you can click on Mysql/Elasticsearch links to view the preloaded data from mysql/elasticsearch containers being rendered.

<p align="center"> <a href="https://drive.google.com/uc?export=view&id=1oDUk_DnPWj6J0yCZJIwVyTL2rgPqDiHF"> <img src="https://drive.google.com/uc?export=view&id=1oDUk_DnPWj6J0yCZJIwVyTL2rgPqDiHF"/></a> </p>

Visit Working or Debugging pages to know more about internal details.