Intercode is a web application that:

• serves as the public-facing web site for a convention
• automates signup and payment
• automates business processes for the convention staff

The original Intercode was written in PHP by Barry Tannenbaum for Intercon New England, and has since been used by several other conventions around the world.

Intercode 2 is a ground-up rewrite of Intercode, making it more robust, more flexible, and more modern.

• Backend: Ruby on Rails application exposing a GraphQL API and an OpenID Connect-enabled OAuth2 server
• Frontend: React and Apollo-based single-page JavaScript app
• Database engine: PostgreSQL
• Background queue system: Amazon SQS + Shoryuken (this might change in the future)
• Production infrastructure: For New England Interactive Literature's installation of Intercode, we're hosting it on Heroku and running it as Docker containers (as opposed to using buildpacks). However, since we removed libgraphql-parser from the build, Heroku buildpacks may also work (but we haven't tested it since removing the library).

• Intercode 2 in development mode uses intercode.test as its cookie domain. If you use localhost to visit the site, that will mysteriously fail. I'm going to try to make the site detect the wrong domain and redirect you, but for now, please just use the intercode.test domain name.
• We used to support a Docker Compose-based development workflow, but this has been deprecated. Please run Rails locally using the instructions below.

This is the classic Rails development setup, and should work for Mac and Linux users.

1. Clone this repository: git clone https://github.com/neinteractiveliterature/intercode.git
2. Make sure you have a working C/C++ development toolchain installed. On macOS, that's Xcode and its Command Line Tools.
3. Install rbenv
4. Install ruby-build
5. Install the Ruby version Intercode requires: rbenv install
6. Install Bundler: gem install bundler
7. Edit your hosts file (typically found in /etc/hosts on Mac and Linux systems) and add the following line: 127.0.0.1 intercode.test
8. From the Intercode source folder:
9. Install all the dependencies of Intercode: 1. Install PostgreSQL. With Homebrew: brew install postgres 2. Make sure you have Node.js installed. With Homebrew: brew install node 3. Make sure you have Yarn installed. With Homebrew: brew install yarn 4. bundle install
10. Set up your local database: bin/rails db:create db:migrate
11. Install JavaScript packages: yarn install
12. Start up the Intercode server: bin/rails server
13. Start up the Webpack server: yarn run start
14. You should now be able to go to http://intercode.test:3000 and see the app running!

If you want to test how the app runs in production, but using your local development installation, you can do so as follows:

1. Build Docker images for Intercode: docker build --target production -t local-intercode-production .
2. Install the dev-proxy npm package: npm install -g dev-proxy
3. Run dev-proxy to start proxying HTTPS locally: dev-proxy -p 5001:5000
4. Run something like the following command, changing the asset host as necessary for your setup: docker run -it -p 5001:3000 -e DATABASE_URL=postgresql://postgres@docker.for.mac.localhost/intercode_development -e RAILS_LOG_TO_STDOUT=true -e ASSETS_HOST=//intercont.intercode.test:5000 -e RAILS_SERVE_STATIC_FILES=true local-intercode-production bin/rails
5. Visit https://some-convention-domain.intercode.test:5000, probably using Firefox (it seems to deal better than Chrome with self-signed certificates these days).

To contact the Intercode 2 project team, you can:

• File an issue or feature request here
• Email Nat Budin.

Participants in the Intercode project are expected to follow the Contributor Covenant. For details, see CODE_OF_CONDUCT.md.

Intercode 2 is released under the terms and conditions of the MIT license. Please see the LICENSE file for the full legalese.