SkyScheduler

Overview

SkyScheduler is a lightweight Cloudflare Workers-based microservice application that allows you and/or your team to schedule/repost posts to a Bluesky account effortlessly. Perfect for content creators and social media managers who want to plan their social media content in advance.

Features

• Multiple user/account handling: Manage multiple users/bsky accounts easily
• Bluesky Post Scheduling: Schedule multiple posts to your Bluesky account
• Hourly Time Slots: Time selection is limited to hourly intervals to optimize worker execution and reduce unnecessary runs
• Simple Setup: Fairly minimal setup and easy to use
• Supports media posts: Automatically handles content tagging and formatting your media so that it looks the best on BSky. Image transforms via Cloudflare Images
• Handles Link Embeds: Post your content with a link embed easily!
• Automatic reposting: Schedule how many times you want your post to be retweeted on the network. Get more visibility and engagement without having to do more work
• Invite Keys: Want to throttle the signups to your portal or keep the pool to friends/org only? Use invite keys to manage signups

Getting Started

Prerequisites

• Node.js (v24.x or later)
• Package Manager
• Cloudflare Pro Workers account (for CPU and Queues [can be disabled with QUEUE_SETTINGS.enabled set to false])

Installation

1. Clone the repository

git clone https://github.com/socksthewolf/skyscheduler.git
cd skyscheduler

2. Copy environment variables template

cp .dev.vars.example .dev.vars

3. Configure your .dev.vars file with the following environment variables:
   • BETTER_AUTH_SECRET - the cryptographic hash to use better auth (you can generate one from this page)
   • BETTER_AUTH_URL - the working url of your site (this should be "*" in dev).
   • DEFAULT_ADMIN_USER - the admin bsky handle
   • DEFAULT_ADMIN_PASS - the admin password
   • DEFAULT_ADMIN_BSKY_PASS - the above account's bsky app password
   • TURNSTILE_PUBLIC_KEY - the turnstile public key for captcha
   • TURNSTILE_SECRET_KEY - the turnstile secret key for captcha
   • RESIZE_SECRET_HEADER - a header value that will be included on requests while trying to resize images. Protects the resize bucket while still making it accessible to CF Images.

Note: When deploying, these variables should also be configured as secrets in your Cloudflare worker dashboard. You can also do this via npx wrangler secret put <NAME_OF_SECRET>.

4. Update your wrangler.toml with changes that reflect your account.

   • You'll need to update the values for the kv, r2, d1 to reflect the bindings on your account.
   • Also make sure you update the BETTER_AUTH_URL to your working url as well.
   • Do remember to remove the domain bindings!

5. Install dependencies

npm install

6. Run the development server

npm run dev

7. Deploy the application to Cloudflare Workers. You might need to login to your Cloudflare account if you haven't already.

npm run deploy

8. Create your D1 tables using the following command, this will set up your tables both locally and remotely. If you encounter issues running remotely, you can run the command again.

npm run migrate:all

9. Modify the metatags located in the metaTags.tsx (these are currently set up for the website attached to this project)

10. Run your application and go to /setup. This will create the admin account.

Configuration

Environment Variables

Ensure you have configured the .dev.vars file with the necessary credentials and settings. The file is git-ignored to protect your sensitive information.

Application Variables

Most of the application can be modified either through the wrangler.toml vars section or via src/limits.d.ts. These are usually heavily commented to explain what the options control.

Minimization

The application by default is configured to use the minified versions of the scripts in assets/js. You can either turn off this behavior in src/limits.d.ts or run npm run minify whenever those files change.

Project Structure

skyscheduler/
├── assets/
├── src/
│   ├── auth/
│   ├── db/
│   ├── endpoints/
│   ├── layout/
│   ├── middleware/
│   ├── pages/
│   ├── utils/
│   └── validation/
├── migrations/
├── .dev.vars
├── .node-version
├── .minify.json
├── drizzle.config.ts
├── package.json
├── tsconfig.json
└── wrangler.toml

Middleware Stack

Server

• Zod - data validation
• BetterAuth - login/authentication
• BetterAuthCloudflare - helper adaption
• hono - request routing/processing
• uuid - id generation
• image-dimensions - image data validation
• date-fns - date processing helpers
• drizzle - database orm/schemas
• just - js helper library

Client

• htmx - client requests and responsiveness
• tribute - client autocomplete library
• toastify - client notifications
• dropzone - file upload negotiation
• pico - styling
• countable - dynamic input counter

Contributing

We welcome contributions!

Ways to Contribute

• Report bugs
• Suggest enhancements
• Submit pull requests

License

This project is licensed under the MIT License - see the LICENSE file for details.