https://github.com/samn/snacks

Contextless Photo Sharing
https://github.com/samn/snacks

firebase firebase-functions google-cloud mailgun nextjs

Last synced: about 19 hours ago
JSON representation

Contextless Photo Sharing

• Host: GitHub
• URL: https://github.com/samn/snacks
• Owner: samn
• License: other
• Created: 2017-05-22T22:04:41.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2023-01-23T23:21:30.000Z (almost 2 years ago)
• Last Synced: 2024-04-14T10:53:32.898Z (7 months ago)
• Topics: firebase, firebase-functions, google-cloud, mailgun, nextjs
• Language: JavaScript
• Homepage: https://snacksnacksnacksnacksnack.com
• Size: 1.37 MB
• Stars: 4
• Watchers: 2
• Forks: 1
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# snacks

[![Build Status](https://travis-ci.org/samn/snacks.svg?branch=master)](https://travis-ci.org/samn/snacks)

## What it is

https://snacksnacksnacksnacksnack.com/

Email a photo to `snack` at that domain and it'll get posted.

There's no metadata or attribution — post cool things and don't be a jerk.

You can run snacks on your own domain using Firebase, Google Cloud Platform, and Mailgun.

## How it works

Mailgun is configured to call a webhook when emails are received.

That webhook (the `receiveEmail` function in this code base) downloads the attachments and processes them in another function (`receivedAttachmentsPubSub`).

EXIF data is stripped, and images are resized and compressed.

The processed images are stored in a Google Cloud Storage bucket, and an index is stored in Google Cloud Datastore.

The `receiveEmail` function generates a BSON Object Id to identify the post.

This id is used throughout the system as a consistent key across functions (logs can be correlated this way).

The original post (at its original resolution but without EXIF data) is archived separately to facilitate reprocessing without recompression.

Object Ids are naturally sorted by time which is convenient for sorting posts by when they were received.

The site is built with Next.js & React.

Posts (a link to the image & its dimensions) are retrieved from the Datastore.

The inital render ocurrs server side, and additional posts are fetched as the page scrolls.

## Additional Docs

* [Firebase Functions Readme](functions/README.md)

* [Production Setup](docs/production.md)

* [Reprocessing Data](docs/reprocessing.md)

## License

Copyright 2017, Sam Neubardt.


This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.