⚠️ End Of Life ⚠️
The `biketag-website` project has reached end of life. We are no longer accepting pull requests or providing support for community users of this code and supporting software. This project started as a tool for people to be able to more easily play BikeTag in Portland, Oregon, socially on Reddit. This code lived much longer than it could have and I, Ken, am so happy that it worked so well for the community of BikeTag Players all over the world. Please see the new [BikeTag App][biketag-vue] for the continued free and open source offering by the BikeTag Project.
A website for biketag.org
To allow anyone and everyone to play BikeTag! This site will ingest the Reddit posts playing biketag for a configured subreddit, and display them on biketag. Conversely, using the site you can create a new tag and will be automagically posted to Reddit! This lets anyone play the game without needing to know how to imgur or having a reddit account, while continuing to support those who have been playing biketag on reddit as well!
Features of the webapp
- See most recent round of BikeTag, and an archive of past rounds: http://portland.biketag.org
- A modal to play the next round (provide matching and new BikeTag images, Mystery Location description, hint, and name): http://portland.biketag.org/#tagit
- See all archived rounds of Biketag: http://portland.biketag.org/?count=all
- See an individual round of BikeTag with matching images: http://portland.biketag.org/95
npm install to install the node module dependencies.
The app loads a set of configuration files found in the config folder. The repository is set to ignore a config.json file, for security reasons, but there's sample of the minimum configuration to get the local site to display images for the Portland subdomain, as well as the default landing page. sample.config.json. Copy this file to config/config.json
cp config.sample.json config/config.json
to get started from scratch. Note: for some features to work, API values will need to be set.
Start local server
npm start to run the webserver and then navigate to http://localhost:80 or whichever port you have set in the config.json. You can also run
npm run dev to run in debugging mode for local development, which provides greater logging and hot-reloading.
Change the website code
index.ejs file in it's root that the express application will serve for a given subdomain. Using data from the config.json file as well as the data found in /data/config/, in conjunction with the raw html in the /data/content/ folder, data can be injected into the ejs templates.
<script> // get the supportedRegions object via JSON serialization var subs = JSON.parse(`<%- JSON.stringify(supportedRegions) %>`) </script>
To use within html:
<audio id="biketag-jingle"> <!-- insert the page.easter.jingle variable into the src attribute of this audio element --> <source src="<%= page.easter.jingle %>" type="audio/mpeg"> </audio>
Note: When running in dev mode, changes to the files in the /templates/ folder are reflected immediately, with the page autoreloading.
This website runs on sexpress, a wrapper around express, which provides a series of configurable features for a multitenant website. These features include subdomain support, api authentication using passport.js, ssl support, and more. Because these features are abstracted out of the biketag-website project, the core of this application lives inside /api/biketag/index.js to handle the BikeTag specific routes and functionality.
Sexpress uses clobfig, a configurator library, which clobbers all of the files found in the /config folder. Clobfig clobbers all of the js files within the config folder that have 'config.js' in their name and all .json files.
Thank you to HorribleLogos.com for whatever it is that you provided.
Structured content powered by Sanity.io