{"id":13993491,"url":"https://github.com/fantasycalendar/Fantasy-Calendar","last_synced_at":"2025-07-22T17:32:40.387Z","repository":{"id":37858235,"uuid":"187174368","full_name":"fantasycalendar/Fantasy-Calendar","owner":"fantasycalendar","description":" Build a calendar that fits your world! Whether you're a GM just here to track your Forgotten Realms campaign with a preset calendar, or a fanciful world-builder with 12 moons (Like Eberron's) and zany timekeeping systems to match, we've got you covered.","archived":false,"fork":false,"pushed_at":"2024-11-16T13:32:23.000Z","size":20584,"stargazers_count":95,"open_issues_count":50,"forks_count":7,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-16T14:27:27.569Z","etag":null,"topics":["calendar","dungeons-and-dragons","fantasy","laravel","rpg","storytelling"],"latest_commit_sha":null,"homepage":"https://app.fantasy-calendar.com","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fantasycalendar.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-17T08:06:59.000Z","updated_at":"2024-10-20T22:34:59.000Z","dependencies_parsed_at":"2024-01-30T05:30:56.989Z","dependency_job_id":"fe7a4609-0bbf-48a3-9166-b45edf12faa1","html_url":"https://github.com/fantasycalendar/Fantasy-Calendar","commit_stats":null,"previous_names":[],"tags_count":62,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fantasycalendar%2FFantasy-Calendar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fantasycalendar%2FFantasy-Calendar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fantasycalendar%2FFantasy-Calendar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fantasycalendar%2FFantasy-Calendar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fantasycalendar","download_url":"https://codeload.github.com/fantasycalendar/Fantasy-Calendar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227143695,"owners_count":17737211,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["calendar","dungeons-and-dragons","fantasy","laravel","rpg","storytelling"],"created_at":"2024-08-09T14:02:24.248Z","updated_at":"2024-11-29T14:33:06.178Z","avatar_url":"https://github.com/fantasycalendar.png","language":"PHP","funding_links":[],"categories":["PHP"],"sub_categories":[],"readme":"# Fantasy-Calendar\n\n[Fantasy-Calendar](https://www.fantasy-calendar.com/) is a general-purpose fantasy calendar creation and tracking software.\n\n## A what?\nWell, whether you're a GM looking to track the events of a long-running Forgotten Realms campaign, an author, or simply a world-builder who likes to have wacky celestial configurations (Such as Eberron's [12 moons](http://archive.wizards.com/default.asp?x=dnd/ebds/20050307a)) with zany timekeeping systems to match, you probably need a calendar of some kind.\n\n\u003e_\"Game time is of utmost importance [...] you can not have a meaningful campaign if strict time records are not kept.\"_  \n-[Gary Gygax](http://www.creightonbroadhurst.com/gygax-on-tracking-time-in-the-campaign/)\n\nFantasy-Calendar seeks to do it all, whether you're creating your own complicated calendar with tons of interesting edge-cases, or using presets such as the Forgotten Realms, Eberron, or Exandria for simple time-keeping.\n\n## Run Using Docker\nWe recommend development using [Docker](https://www.docker.com/), as it's what we use and it makes things like setting up the PHP environment a breeze. As long as you already have Docker installed, actually getting up and running is pretty straightforward. First you'll want to run:\n\n```shell\n$ make\n```\n\nThat runs the default `initialize_dev` entry in FC's `Makefile`, which:\n- Copies the default .env to the appropriate location\n- Builds all of FC's container images\n- Installs `npm` dependencies\n- Installs `composer` dependencies\n- Starts docker containers\n- Runs `artisan migrate`\n- Stops docker containers\n\nWe've also provided a handy `aliases.sh` to make some common tasks/aliases/etc., easier. So, after you've run `make`, we recommend `source aliases.sh`. I'd list all the aliases here, but ... just go read the file, it's super straightforward.\n\n### The Containers\nThe default `docker-compose up` will create quite a few containers:\n\n|Container|Purpose|\n|---|-------|\n| `fc-mariadb`| MariaDB, configured to create a default database .|\n| `fc-bref-web`                  | nginx web server, configured to appropriately.|\n| `fantasy_calendar_php`              | An extended `php-fpm`  with PDO and composer installed, as well as some default environment variables for a docker setup.|\n|`selenium` | This is a headless Chrome install used for integration tests |\n|`fcredis`| A [Redis](https://redis.io/) container, used for caching and queues |\n| `fantasy-calendar-composer-install` | This is a once-run, randomly-named container that does one thing: runs `composer install` . This makes it so that running a simple `docker-compose up`  or `docker-compose up -d`  any time you pull the latest version of this repo will make sure you have the latest versions of any composer-managed packages.|\n|`npm`| This runs `npm run dev-install-watch`, which installs deps and automatically rebuilds assets as they change. |\n|`mailhog`| Available on `localhost:8025`, Mailhog captures outgoing mail. |\n\n\nIf everything has gone smoothly, after `make` and `docker-compose up`, you should have a functional development environment available at http://localhost:9980/.\n\n## Setting up your own environment\nFantasy Calendar is just a Laravel app. So you'll need the [usual installation process](https://laravel.com/docs/7.x/installation) for a Laravel application, along with two extra PHP extensions: `imagick` and `gmp`.\n\n## Contributing\nPull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffantasycalendar%2FFantasy-Calendar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffantasycalendar%2FFantasy-Calendar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffantasycalendar%2FFantasy-Calendar/lists"}