Skip to content

okTurtles/group-income

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Group Income (Simple Edition)

About

Group Income is voluntary, decentralized, end-to-end encrypted basic income for you and your friends.

Getting Started

  1. Install Node.js
  2. Install Grunt: npm install -g grunt-cli
  3. Clone this repo (or a fork of it if you plan on contributing) and cd into it.
  4. Install dependencies: npm install
  5. Now try out the dev workflow.

Contributing

We use standard for the code style and Github project boards for efficient project management.

js-standard-style

We are continually improving the user experience for everyone, and applying the relevant accessibility standards. We will be conformant with WCAG 2.0 Level AA and trying our best to reach Level AAA in some areas of the application.

Level Double-A conformance, W3C WAI Web Content Accessibility Guidelines 2.0

Read first

Bounties

Some issues have bounties assigned to them.

  • Anyone can post a bounty by donating to this project and letting us know which issue you'd like the bounty to be applied to.
  • Non-contractors can receive bounties by submitting PRs for them. If we approve and merge the PR, you get the bounty!
  • If there's an issue you'd like okTurtles to prioritize by posting a bounty to it, feel free to let us know via Slack!

Any open contractor positions are posted to: Open Positions

Basic workflow

To get started with development, follow the steps in Getting Started first.

Run all servers + watch files for changes

grunt dev

Create a tunnel to share access over the Internet:

grunt dev --tunnel

Important

This service (localtunnel) doesn't seem to work anymore. Instead please try localhost.run or serveo instead, e.g.:

$ grunt dev
# then, in another terminal:
$ ssh -R 80:localhost:8000 [email protected]

Build the app for distribution

grunt deploy

Clean up files in dist/

grunt clean

Run tests.

NOTE: You may need to first install Cypress using ./node_modules/.bin/cypress install

# all tests
grunt test

# all tests while skipping build step
grunt test --skipbuild

# unit tests only (always skips build)
grunt test:unit

# show e2e tests (Cypress) live in a browser
grunt test --browser

# run e2e tests (Cypress) in "open" mode
grunt test --browser=debug

# Developing at the same time as writing E2E tests
grunt dev
# and in another terminal run Cypress in "open" mode
npm run cy:open

# Run a specific Cypress spec against the running 'grunt dev' server:
npx cypress run -c 'baseUrl=http://localhost:8000' --spec "test/cypress/integration/group-chat.spec.js"

Using Docker for extra security

You can run commands in a Docker container by using npm run docker -- <cmd> instead.

For example:

npm run docker -- npm install
npm run docker -- grunt dev
npm run docker -- grunt test --skipbuild

For details, see: Docker.md

Troubleshooting

If you run into any errors during the setup, try the suggestions in Troubleshooting.md.

Donating

Donations to the okTurtles Foundation support the development of Group Income and related projects.

License

AGPL-3.0. See LICENSE for license details and CONTRIBUTING.md for the contribution policy.