{"id":15489747,"url":"https://github.com/theandrew168/bloggulus","last_synced_at":"2025-07-20T06:03:54.427Z","repository":{"id":40549924,"uuid":"292041703","full_name":"theandrew168/bloggulus","owner":"theandrew168","description":"A collective index of my favorite blogs","archived":false,"fork":false,"pushed_at":"2025-06-22T16:34:10.000Z","size":2865,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-15T13:46:38.348Z","etag":null,"topics":["blogging","golang","postgresql","rss"],"latest_commit_sha":null,"homepage":"https://bloggulus.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theandrew168.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-09-01T15:52:25.000Z","updated_at":"2025-06-22T16:34:14.000Z","dependencies_parsed_at":"2024-02-25T19:33:43.503Z","dependency_job_id":"8ca294ef-2fc5-4e07-9f64-583b8427709e","html_url":"https://github.com/theandrew168/bloggulus","commit_stats":{"total_commits":856,"total_committers":4,"mean_commits":214.0,"dds":"0.24415887850467288","last_synced_commit":"376fafd16d0189fcb938e7524a4e09d7a8eb1664"},"previous_names":[],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/theandrew168/bloggulus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theandrew168%2Fbloggulus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theandrew168%2Fbloggulus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theandrew168%2Fbloggulus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theandrew168%2Fbloggulus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theandrew168","download_url":"https://codeload.github.com/theandrew168/bloggulus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theandrew168%2Fbloggulus/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266076013,"owners_count":23872729,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blogging","golang","postgresql","rss"],"created_at":"2024-10-02T07:07:35.194Z","updated_at":"2025-07-20T06:03:54.123Z","avatar_url":"https://github.com/theandrew168.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bloggulus\n\nBloggulus is a web application for aggregating and indexing your favorite blogs.\nI wrote it to serve as a less engaging and more personalized version of sites like Hacker News or Reddit.\n\n## Local Development\n\nWhile the primary [Bloggulus website](https://bloggulus.com) represents my own personal collection of blogs, it is designed to be easily self-hostable.\nCheck out the [releases page](https://github.com/theandrew168/bloggulus/releases) for pre-built binaries.\n\n### Setup\n\nThis project depends on the [Go](https://golang.org/dl/) programming language.\n\n### Database\n\nThis project uses [PostgreSQL](https://www.postgresql.org/) for persistent storage.\nTo develop locally, you'll an instance of the database running somehow or another.\nI find [Docker](https://www.docker.com/) to be a nice tool for this but you can do whatever works best.\n\nThe following command starts the necessary containers:\n\n```bash\ndocker compose up -d\n```\n\nThese containers can be stopped via:\n\n```bash\ndocker compose down\n```\n\n### Running\n\nRun the application (with automatic restarts via [wgo](https://github.com/bokwoon95/wgo)):\n\n```bash\nmake run\n```\n\n### OAuth Services\n\nFor authentication, this project relies on OAuth social sign ins (from GitHub and Google).\nTo work on the auth system, you'll need to create a `bloggulus.local.conf` file that contains the necessary OAuth credentials for each service.\nIf you need these credentials, feel free to reach out.\n\nThen, you can run the app using the local config file with:\n\n```bash\nmake run-local\n```\n\nOtherwise, you can simply run the application normally (without OAuth configured) and use the local-only debug sign in.\nThis is enabled by default (via the `ENABLE_DEBUG_AUTH` environment variable) for the `run` and `run-local` targets.\n\n### Testing\n\nTests can be ran after starting the necessary containers:\n\n```bash\nmake test\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheandrew168%2Fbloggulus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheandrew168%2Fbloggulus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheandrew168%2Fbloggulus/lists"}