Skip to content

Make snapshots look 🔥 with a pretty backgroud

License

Notifications You must be signed in to change notification settings

weiplanet/pretty-snap

 
 

Repository files navigation

Preview video

Make your screenshot 🔥 with a pretty background

👋 Introduction

Make your screenshots pop with beautiful backgrounds. Use them for:

  • Product screenshots on landing pages
  • Social media summary cards (e.g. Twitter or FB)
  • Simply sharing screenshots on social media

🍕 Develop

Get started without external APIs. Access on localhost:1234.

npm install
npm start

Unsplash API (Optional)

Pretty Snap uses the Unsplash API to get images and Cloudflare Workers to proxy API requests signed with an Unsplash access key.

Both service provide a generous free tier which you can use for development and production.

Setup Unsplash:

  1. Create an Unsplash app
  2. Copy the Unsplash Access Key value

Note: Requests are limited to 50 per hour until your API key is approved for production

Setup a Cloudflare worker:

  1. Create a Cloudflare worker
  2. Manually paste cloudflare/worker.js code into the online console
  3. Open the worker's settings and add this environment variable:
    Variable Name Value
    ACCESS_KEY The Unsplash Access Key value from the previous step

Test the API

  1. Open the Cloudflare worker's online console
  2. Append /api/search?query=nature to the generated url
  3. Run the request
  4. A 200 response with Unsplash JSON data should display

Use the API

  1. Copy the generated base url of your Cloudflare worker
    • e.g. https://<prefix>.<user>.workers.dev
  2. Create a .env file (you can use .env.example as a template)
  3. Set the value of URL_API to the worker's url
    • e.g. URL_API=https://<prefix>.<user>.workers.dev
  4. Set the value of DEV_USE_API to true or remove it completely
  5. Delete the Parcel generated .cache folder
  6. Rebuild the app

🌍 Deploy

Pretty Snap is deployed statically and uses the Cloudflare worker as an API.

  1. Deploy statically via a provider like Netlify.
  2. Set the build command to npm run build and output directory to dist
  3. Set the environment variable URL_API to the Cloudflare work base url
    • The DEV_USE_API variable can be ignored

Use the API on the same domain (Optional)

Cloudflare allows workers to run on the same domain even when hosted on an external server.

  1. Open the Cloudflare DNS tab and configure DNS as follows:
    Type Name Content TTL Proxy status
    CNAME some-domain.com <subdomain>.netlify.app Auto Proxied
    CNAME www some-domain.com Auto Proxied
  2. Open the Cloudflare Workers tab and add the following route
    Route Worker
    *some-domain.com/api* <select your worker>

Pretty Snap should still render when visiting some-domain.com but XHR requests to some-domain.com/api will now hit the worker. You now have a server and API running on the same domain but hosted in 2 locations 🤯


🐼 Sponsors

Panda Snap logo

Design faster by 'snapping' images to create a personal design collection.

It's the best design orientated snipping tool - it's free too!

🐼 Visit Panda Snap

About

Make snapshots look 🔥 with a pretty backgroud

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 93.4%
  • JavaScript 3.5%
  • HTML 1.7%
  • CSS 1.4%