mre / zerocal

🚫📆 Serverless calendar built with shuttle.rs

zerocal 🚫📆

Welcome to zerocal, the serverless calendar.
It allows you to create calendar invites from the convenience of your terminal!
🔗 Here's my blog post about the project.

Usage

curl https://zerocal.shuttleapp.rs?start=2022-11-04+20:00&duration=3h&title=Birthday&des
cription=paaarty > party.ics
open party.ics

Web UI

You can also use the web UI at https://zerocal.shuttleapp.rs

Self-hosting

You can also self-host zerocal. To do so, compile the binary with cargo build --release --features local and run it with ./target/release/zerocal. The server will listen on port 8000 by default.

Contributing

Please check the issue tracker for contribution ideas. Any pull request is welcome. ❤️

To run a local development version install cargo-watch and then run

make local

You can also run a dev version on shuttle.rs with

make dev

Derivatives

Was your project inspired by zerocal? Add it here!

• kiwical - Kiwi Calendar built with Typescript on Deno Deploy.

Credits

This app was built with the help of 🚀 shuttle.rs, the web application platform for Rust.

zerocal's Issues

Missing "LICENSE" - or is this not under any re-use license?

See topic

Add short-link support

E.g. zerocal.shuttleapp.rs/2022-11-04T20:00/3h/Birthday/Party.
I'm willing to discuss alternative URL formats before we decide on one.

Add Google calendar short-links

Example: https://calendar.google.com/calendar/render?action=TEMPLATE&dates=20221003T224500Z%2F20221003T224500Z&details=&location=&text=

Add a HTML version of the event response

When a recipient clicks the link, it would be nice if they got a HTML page first. The page could contain links to download as ical, add to Google Calendar etc.

Add location support

• location=Berlin
• location=https://zoom.us/test

Web GUI cannot set a custom timezone

Seems that the browser's local timezone is used (without inspecting code)

I would like a way to set to use my timezone by default, or manually select one from a dropdown list ala google:

Even just manually setting the offset from UTC would be ok too as an MVP.

CI tries to deploy to Shuttle from forks

Is it possible to check if we're here or on a fork before deploying to Shuttle?

Add support for timezones

Add support for self-hosting

Add example bash command to create a calendar event from the command line

Example:

curl https://zerocal.shuttleapp.rs?start=2022-11-04+20:00&duration=3h&title=Birthday&description=paaarty

Cannot use unicode in fields 😭

Emoji work fine if downloaded from the gui, but no output on the CLI if used. MRE:

# fails
curl -LG https://zerocal.shuttleapp.rs/ -d title=Valid -d desc=🍺+to+catch+up!
# works
curl -LG https://zerocal.shuttleapp.rs/ -d title=Valid -d desc=beers+to+catch+up!

503 "project not ready. Try running `cargo shuttle project restart`."

Cannot chekout the demo 😭 https://zerocal.shuttleapp.rs/

Add support for QR code generation

Use case: as a meeting organizer, i want to quickly create an event on my phone, then share that meeting with my friends though a QR code on my phone

QR code would either be the link to the event or the link to the calendar file

🌈 Beautiful UI?

I'm not a designer. Can anyone create a beautiful design for zerocal? 🎨
The entire HTML and CSS is in this file: https://github.com/mre/zerocal/blob/main/static/index.html.

URL/Location cannot include `#`

URLs are truncated for anything including a #
MRE:

curl -LG https://zerocal.shuttleapp.rs/ -d title=matrix -d location="https://matrix.to/#/#a-channel:matrix.org"

BEGIN:VCALENDAR
VERSION:2.0
PRODID:ICALENDAR-RS
CALSCALE:GREGORIAN
BEGIN:VEVENT
DTSTAMP:20221010T153700Z
DESCRIPTION:Powered by zerocal.shuttleapp.rs
DTEND:20221010T163700Z
DTSTART:20221010T153700Z
LOCATION:https://matrix.to/
SUMMARY:matrix
UID:0d85aec2-c585-44e5-a80e-c9464e9c5572
END:VEVENT
END:VCALENDAR

Perhaps a # to %23 conversion could fix this? Was needed on twitter for these links as an example to be valid and work a while ago (now patched).

A clone in Typescript/Deno Deploy

Hi! I really liked this project and found it inspiring to make a clone in Typescript on Deno Deploy. If you are curious you can see it here - https://kiwical.deno.dev/ Thank you for the inspiration!

Add support for more human-readable date formats

Examples:

• now
• tomorrow
• now+2d

Add support for recurring events

• Daily
• Weekly
• Monthly
• Yearly

I'm open for suggestions for the URL syntax.

Setting duration to "dog" (or any other unparseable value) responds with a 500 error

Setting duration to "dog" (or any other unparseable value) responds with a 500 error.

I was just noticing this when reading the blog article and thinking about how rust doesn't necessarily protect from logic edge cases 😄