SpiffWorkflow is a software development platform for building, running, and monitoring executable diagrams https://www.spiffworkflow.org/

Go to file

jbirddog 6874e626c8 Remove and ignore UNKNOWN.egg-info (#272 )		2023-05-23 11:47:13 -04:00
.github	record if the workflow run that triggered us was a push	2023-05-19 11:33:56 -04:00
bin	comment script	2023-03-16 23:11:17 -04:00
connector-proxy-demo	select intiator in filters when you don't have permission to search users.	2023-03-13 11:50:18 -04:00
docs	Fixing Dan's constant seplling mistakes	2023-05-23 11:43:50 +05:00
spiffworkflow-backend	Support custom run at time when creating an instance (#270 )	2023-05-23 09:52:01 -04:00
spiffworkflow-frontend	fixed tests related to new permissions w/ burnettk	2023-05-22 14:58:51 -04:00
.darglint	added some base stuff to get pyl working	2022-10-27 09:15:56 -04:00
.flake8	pyl and turn back on autoreload for homepage w/ burnettk	2023-04-13 16:56:49 -04:00
.gitignore	Remove and ignore UNKNOWN.egg-info (#272 )	2023-05-23 11:47:13 -04:00
.pre-commit-config.yaml	increase line length from 88 to 119 for black w/ burnettk	2023-03-15 16:24:08 -04:00
.readthedocs.yaml	use requirements.txt for readthedocs build.	2023-05-18 11:26:47 -04:00
.tool-versions	Move to Python 3.11 (#27 )	2022-11-09 13:45:16 -05:00
Jenkinsfile	ci: add deploy tag to commit to avoid race conditions	2023-05-18 11:03:52 +02:00
LICENSE	Initial commit	2022-10-12 10:17:40 -04:00
README.md	update setup steps	2023-05-22 09:31:08 -07:00
docker-compose.yml	more config updates w/ burnettk	2023-02-16 10:21:02 -05:00
poetry.lock	updated Spiffworkflow and updated terminated test to ensure tasks are deleted from the db w/ burnettk	2023-05-10 16:39:03 -04:00
pyproject.toml	added back in missing required libs w/ burnettk	2023-03-28 16:19:31 -04:00

README.md

spiff-arena

SpiffArena is a low(ish)-code software development platform for building, running, and monitoring executable diagrams. It is intended to support Citizen Developers and to enhance their ability to contribute to the software development process. Using tools that look a lot like flow-charts and spreadsheets, it is possible to capture complex rules in a way that everyone in your organization can see, understand, and directly executable.

Please visit the SpiffWorkflow website for a Getting Started Guide to see how to run SpiffArena locally and try it out. There are also additional articles, videos, and tutorials about SpiffArena and its components, including SpiffWorkflow, Service Connectors, and BPMN.js extensions.

Contributing

This is a monorepo based on git subtrees that pulls together various spiffworkflow-related projects. Feel free to ignore that and drop us a pull request. If you need to push back from the monorepo to one of the individual repos, here's an example command (and find other scripts we use in the bin directory):

git subtree push --prefix=spiffworkflow-frontend git@github.com:sartography/spiffworkflow-frontend.git add_md_file

Backend Setup

First install python and poetry, and then:

cd spiffworkflow-backend
poetry install
./bin/run_server_locally

Frontend Setup

First install nodejs, ideally the version in .tool-versions (but likely other versions will work). Then:

cd spiffworkflow-frontend
npm install
npm start

Run tests

./bin/run_pyl

Requires at root:

.darglint
.flake8
.pre-commit-config.yaml
pyproject.toml

Run cypress automated browser tests

Get the app running so you can access the frontend at http://localhost:7001 in your browser by following the frontend and backend setup steps above, and then:

./bin/run_cypress_tests_locally

License

SpiffArena's main components are published under the terms of the GNU Lesser General Public License (LGPL) Version 3.

Support

You can find us on our Discord Channel.

Commercial support for SpiffWorkflow is available from Sartography.