combine
Combine (harvester)
This is a project written using Amber. Enjoy!
Getting Started
These instructions will get a copy of this project running on your machine for development and testing purposes.
Prerequisites
This project requires Crystal (installation guide).
Alternatively, docker compose up
should bring up a container based setup (untested).
Initial setup
The environment configuration files are encrypted in git, so to run the project you'll need the key from 1Password:
op read op://Shared/rasikyplntusmmbszukvobmjz4/password >.encryption_key
Google Auth
To create Google OAuth credentials for single signon, go to Google Cloud Console and create a project for the app. Visit "Credentials" in the "APIs & Services" product, and create an OAuth client ID. The /signin/callback
URL of your Combine instance should be added to "Authorized redirect URIs", and the "People API" should be enabled for the project.
Changelog
The changelog records the latest changes.
Development
To start your Amber server:
- Install dependencies with
shards install
- Build executables with
shards build
- Create and migrate your database with
bin/amber db create migrate
. - Start Amber server with
bin/amber watch
Now you can visit http://localhost:3000/ from your browser.
Tests
To run the test suite:
crystal spec
Contributing
- Fork it ( https://github.com/reload/combine/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request
Contributors
- xendk Thomas Fini Hansen - creator, maintainer
combine
- 0
- 0
- 2
- 0
- 11
- about 1 month ago
- June 6, 2024
Fri, 22 Nov 2024 15:14:05 GMT