t_cal

main branch1 version
  • main branchlatestApr 16, 2025

github.com/digitalcora/t-cal

Calendar of planned disruptions on MBTA rapid transit

6 stars
0 dependents
License: MIT

Installation

# Add this to your shard.yml
dependencies:
  t_cal:
    github: digitalcora/t-cal
    branch: main

main is a branch, not a release, so this tracks it rather than pinning a version.

Then run:

shards install

shard.yml

Crystal
~> 1.16.0
License
MIT
Author
Cora Grant
Targets
  • server from src/main.cr
  • raven.crash_handler from lib/raven/src/crash_handler.cr

Dependencies

Runtime Dependencies

  • markd~> 0.5.0github: icyleaf/markd
  • raven~> 1.9.0github: Sija/raven.cr
  • tasker~> 2.1.4github: spider-gazelle/tasker
  • memory_cache~> 0.4.1github: kostya/memory_cache

Development Dependencies

  • ameba~> 1.6.0github: crystal-ameba/amebadev

README

TCal

A calendar of planned service disruptions on MBTA rapid transit, provided as a web page and an iCal feed. See the live site at: https://tcal.digitalcora.net

Setup

  1. Install Crystal
  2. shards install

asdf install may also be used, but is not recommended, since this doesn't install any of the system-level packages Crystal depends on.

Development

  • Run the server: crystal src/main.cr
  • Generate docs: crystal docs (then open docs/index.html)
  • Lint the code: bin/ameba

Production

To build a standalone binary bin/server:

  • shards build --production --release --static

The current production instance runs on Fly, using the fly.toml included in the repo.

Configuration

The server supports these environment variables:

  • HOST — The network address to listen on. Default value is 127.0.0.1, meaning the server will only be accessible from localhost. Use 0.0.0.0 to listen on all addresses.

  • PORT — The TCP port to listen on. Default value is 8080.

  • ORIGIN — The canonical origin (scheme + host + optional port) of the site. When a request includes a Host and it is not the canonical origin's host, it will be redirected to the same path at the canonical origin. Default value is http://localhost plus the configured PORT.

  • LOG_LEVEL — The log level. Default value is info. See the Log documentation for valid log levels.

  • SENTRY_DSN — If set, unhandled exceptions will be reported to Sentry.

  • SENTRY_ENVIRONMENT — The environment string used for Sentry reports, if enabled. Default value is default.

Documentation

Read the API docs

Built from the current release. The first visit to a release nobody has asked for starts its build.

Links

This branch

Branch
main
Seen
Apr 16, 2025
Crystal
~> 1.16.0
Indexed
yes

Dependents

No indexed shard depends on this one yet.

Repository

github.com/digitalcora/t-cal

Metadata

Created
Aug 12, 2026
Updated
Aug 15, 2026
Synced
Aug 15, 2026
Versions
1