Forem: howyi

📡 Built "rundown" — An AI-Powered RSS Reader at Railway Hackathon

howyi — Mon, 11 Aug 2025 09:09:11 +0000

📝 Overview

"rundown" crawls your subscribed RSS feeds every 15 minutes, detects new or updated articles, and sends you a neat AI-powered summary. You can tweak the summary language & length, and get notifications via Discord Webhook.

source code: https://github.com/howyi/rundown

I jumped into Railway Hackathon 2025 and built "rundown" — an AI-powered RSS reader that keeps an eye on your feeds, auto-summarizes new content, and pings you when something fresh drops. Here’s a quick tour of what it does, how it’s built, and what it was like to make it all happen on Railway.

The app is live on Railway at https://rundown.sbox.studio (not sure how long I’ll keep it up after the hackathon 🥴).

📝 Overview

✨ Key Features

📚 1. RSS Feed Registration & Management

Add as many RSS feeds as you like and manage them all in one place.

🔍 2. Update Detection + AI Summarization

Every 15 minutes, it scans your feeds, finds the new stuff, and summarizes it using gpt-5-nano. Multi-language & adjustable length support included.

🗓 3. Timeline View

See all your summarized articles in chronological order, with easy browsing of past updates.

🔔 4. Discord Webhook Notifications

Get instant updates in your Discord channels — perfect for teams or communities.

🔗 5. MCP Integration

Hook it into your own tools and grab feed/article data programmatically.

You can connect to the MCP server running at rundown.sbox.studio/mcp using an API key generated from the settings page.
The MCP server is built with Vercel’s mcp-handler

🛠 Tech Stack

Frontend & Auth

Next.js for UI + Backend-for-Frontend
better-auth for simple email/password login

Backend Processing

BullMQ + Redis for async jobs
OpenAI gpt-5-nano for AI summaries

Database

PostgreSQL for feeds, articles, summaries, and user settings

⚙️ Built on Railway

Everything’s running on Railway as separate services:

Next.js App
BullMQ Worker
Redis
PostgreSQL
Bootstrap (runs migrations + re-registers cron jobs after deploy)

The code’s open-source here → GitHub 🐙
You can also spin up your own with this Railway Template — just drop in your OpenAI API key and you’re good to go.

💡 Takeaways

Railway made the whole multi-service setup ridiculously smooth — from creating services to managing env vars and logs. It’s a great fit for hackathons where you want to focus on building, not fighting your infrastructure.

Next steps? More notification channels and fancier diff analysis.
If you’re thinking about joining the next Railway Hackathon — do it. You’ll ship fast, meet cool people, and have fun doing it.

🍗Show Dev: Posting Twitter search results to Slack for free and without writing code using AWS Amplify

howyi — Wed, 21 Aug 2019 10:15:33 +0000

Repository

howyi / tweettoslack

Search Twitter and send results to Slack automatically.
Work on your AWS.

Cost

It's free because it's all within the AWS Free Tier.

Requirements

Slack Incoming Webhook URL
- SLACK_WEBHOOK_URL
Twitter API Token
- TWITTER_CONSUMER_KEY
- TWITTER_CONSUMER_SECRET
- TWITTER_ACCESS_TOKEN_KEY
- TWITTER_ACCESS_TOKEN_SECRET

Deploy

Click the DEPLOY TO AMPLIFY CONSOLE button.
After deploy, access to Lambda tweettoslack-amplify. and set environment variables.
- SEARCH_QUERY: Twitter standard search operators

Diagram

View on GitHub

ScreenShot

Cost

It's free because it's all within the AWS Free Tier.

Requirements

Slack Incoming Webhook URL
- SLACK_WEBHOOK_URL
Twitter API Token
- TWITTER_CONSUMER_KEY
- TWITTER_CONSUMER_SECRET
- TWITTER_ACCESS_TOKEN_KEY
- TWITTER_ACCESS_TOKEN_SECRET # Deploy
Click the DEPLOY TO AMPLIFY CONSOLE button.
After deploy, access to Lambda tweettoslack-amplify. and set environment variables.
- SEARCH_QUERY: Twitter standard search operators

🐔 I made a PHP Library "Conv-Laravel": Auto-generate MySQL migration queries. 🤖

howyi — Tue, 19 Mar 2019 15:25:32 +0000

full size

howyi / conv-laravel

MySQL migration query auto generate on Laravel/Lumen

conv-laravel

MySQL migration query auto generate on Laravel/Lumen

Install

require library (Laravel/Lumen)

composer require "howyi/conv-laravel" --dev

publish config (only Laravel)

php artisan vendor:publish --provider="Howyi\ConvLaravel\ConvServiceProvider"

schema initialize (Laravel/Lumen)

php artisan conv:reflect

generate CREATE queries on database/schemas

Usage

edit CREATE query (in schema directory)
php artisan conv:generate to generate migrations from actual Database - CREATE queries
php artisan migrate to migration

View on GitHub

feature

Generate MySQL migration queries from actual DB (\PDO) and DDLs (CREATE queries)

motivation

I'm tired of writing migration queries ... 😌

install

require library (Laravel/Lumen)

composer require "howyi/conv-laravel" --dev

publish config (only Laravel)

php artisan vendor:publish --provider="Howyi\ConvLaravel\ConvServiceProvider"

schema initialize (Laravel/Lumen)

php artisan conv:reflect

generate CREATE queries on database/schemas

usage

edit CREATE query (in schema directory)
php artisan conv:generate to generate migrations from actual Database - CREATE queries
php artisan migrate to migration

example

example repository 😉

howyi / conv-laravel-example

Example repository for conv-laravel

View on GitHub

🍗Show Dev: json-schema-mapper - JSON Schema convert to jsonSerializable PHP classes

howyi — Wed, 06 Feb 2019 13:20:32 +0000

⭐

howyi / json-schema-mapper

JSON Schema Object|Enum to PHP classes

json-schema-mapper

JSON Schema Object|Enum to PHP classes

document: https://howyi.gitbooks.io/json-schema-mapper/

composer require howyi/json-schema-mapper

./vendor/bin/jsm map [jsonDir] [phpDir] [namespace] [templatePath]

View on GitHub

motivation

I am tired of making a PHP class that matches Json-schema anymore 😵

install

$ composer require howyi/json-schema-mapper

usage

Specify the target JSON directory and the map (PHP) directory and namespace and execute

$ ./vendor/bin/jsm map [jsonDir] [phpDir] [namespace] [templatePath]

description

A library that generates PHP classes that can be acquired from JSON Schema with \json_encode()

Convert JSON Schema type to PHP type as much as possible and do type hint

When "type is string and format is date-time", the type hint becomes \ DateTimeInterface and when converting the array automatically performs ->format(\ DateTime::RFC3339)

The object specified by $ ref is converted to a type hint to the mapped interface

Enum is generated alone as an Enum class that inherits Eloquent\AbstractEnumration

example

file

JSON (sushi.json)

{
  "title": "寿司情報",
  "type": "object",
  "properties": {
    "sushiId": {
      "title": "寿司ID",
      "type": "integer"
    },
    "sushiName": {
      "title": "寿司の名前",
      "type": "string"
    },
    "eatable": {
      "title": "食べられるか",
      "type": "boolean"
    },
    "length": {
      "title": "寿司の長さ",
      "type": "number"
    },
    "osakanaType": {
      "title": "お魚タイプ",
      "$ref": "osakanaType.json"
    },
    "neta": {
      "title": "ネタ",
      "$ref": "./neta.json"
    },
    "shari": {
      "title": "シャリ",
      "$ref": "./shari.json"
    },
    "expirationDate": {
      "title": "消費期限",
      "type": "string",
      "format": "date-time"
    }
  },
  "required": [
    "sushiId",
    "sushiName",
    "eatable",
    "osakanaType",
    "neta",
    "shari",
    "expirationDate"
  ],
  "additionalProperties": true
}

Converted PHP(Class)

<?php

namespace Json\Sushi;

use Json\OsakanaType;
use Json\Neta\NetaInterface;
use Json\Shari\ShariInterface;

class Sushi implements SushiInterface
{
    use SushiTrait;

    protected $sushiId;
    protected $sushiName;
    protected $eatable;
    protected $length;
    protected $osakanaType;
    protected $neta;
    protected $shari;
    protected $expirationDate;
    protected $additionalProperties;

    public function __construct(
        int $sushiId,
        string $sushiName,
        bool $eatable,
        ?float $length,
        OsakanaType $osakanaType,
        NetaInterface $neta,
        ShariInterface $shari,
        \DateTimeInterface $expirationDate,
        array $additionalProperties = []
    ) {
        $this->sushiId = $sushiId;
        $this->sushiName = $sushiName;
        $this->eatable = $eatable;
        $this->length = $length;
        $this->osakanaType = $osakanaType;
        $this->neta = $neta;
        $this->shari = $shari;
        $this->expirationDate = $expirationDate;
        $this->additionalProperties = $additionalProperties;
    }

    public function sushiId(): int
    {
        return $this->sushiId;
    }

    public function sushiName(): string
    {
        return $this->sushiName;
    }

    public function eatable(): bool
    {
        return $this->eatable;
    }

    public function length(): ?float
    {
        return $this->length;
    }

    public function osakanaType(): OsakanaType
    {
        return $this->osakanaType;
    }

    public function neta(): NetaInterface
    {
        return $this->neta;
    }

    public function shari(): ShariInterface
    {
        return $this->shari;
    }

    public function expirationDate(): \DateTimeInterface
    {
        return $this->expirationDate;
    }

    public function additionalProperties(): array
    {
        return $this->additionalProperties;
    }
}

Converted PHP(Trait)

<?php

namespace Json\Sushi;

trait SushiTrait
{
    use \JsonSchemaMapper\ObjectTrait;

    public function jsonProperties(): array
    {
        return [
            'sushiId',
            'sushiName',
            'eatable',
            'length',
            'osakanaType',
            'neta',
            'shari',
            'expirationDate',
        ];
    }

    public function allowAdditionalProperties(): bool
    {
        return true;
    }
}

Converted PHP(Interface)

<?php

namespace Json\Sushi;

use JsonSchemaMapper\JsonArrayAccess;
use Json\Neta\NetaInterface;
use Json\OsakanaType;
use Json\Shari\ShariInterface;

interface SushiInterface extends JsonArrayAccess, \JsonSerializable
{
    public function toJsonArray(): array;

    public function jsonProperties(): array;

    public function allowAdditionalProperties(): bool;

    public function sushiId(): int;

    public function sushiName(): string;

    public function eatable(): bool;

    public function length(): ?float;

    public function osakanaType(): OsakanaType;

    public function neta(): NetaInterface;

    public function shari(): ShariInterface;

    public function expirationDate(): \DateTimeInterface;

    public function additionalProperties(): array;
}