{"id":47719340,"url":"https://github.com/natyconnor/berean","last_synced_at":"2026-06-26T23:00:51.584Z","repository":{"id":340876470,"uuid":"1167146966","full_name":"natyconnor/berean","owner":"natyconnor","description":"An app to facilitate notes on specific Bible verses","archived":false,"fork":false,"pushed_at":"2026-06-17T18:40:03.000Z","size":9921,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-17T19:23:58.430Z","etag":null,"topics":["bible","scripture","study"],"latest_commit_sha":null,"homepage":"https://berean.nathanconnor.dev","language":"TypeScript","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/natyconnor.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-02-26T01:42:11.000Z","updated_at":"2026-06-17T18:38:49.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/natyconnor/berean","commit_stats":null,"previous_names":["natyconnor/bible-notes"],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/natyconnor/berean","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natyconnor%2Fberean","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natyconnor%2Fberean/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natyconnor%2Fberean/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natyconnor%2Fberean/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/natyconnor","download_url":"https://codeload.github.com/natyconnor/berean/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natyconnor%2Fberean/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34835779,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-26T02:00:06.560Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["bible","scripture","study"],"created_at":"2026-04-02T19:15:00.416Z","updated_at":"2026-06-26T23:00:51.579Z","avatar_url":"https://github.com/natyconnor.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Berean\n\nBerean is a scripture notes app focused on verse by verse note taking, emphasizing careful and intentional notes based on the text. Inspired by Acts 17:11 where the Bereans are described as eagerly examining the scriptures, this app invites Christians to do the same, methodically studying God's word verse by verse, and recording down the insights God grants.\n\n**Features**\n\n- Passage reader with chapter navigation and tabbed workspaces\n- Compose and read modes for verse-linked notes, including multi-verse ranges\n- Tag notes for later search and categorization, as well as link notes to other verses.\n- Full-text note search with tag filters and scripture context\n- Tag catalog with starter tags, custom tags, and category colors\n- Import notes from `.xlsx` or `.zip` workbooks (export UI is present but currently disabled)\n- Guided tutorial tours for the main workflow and advanced search\n\n**Integrations And Keys**\n\n- Convex (database, serverless functions, auth): requires a Convex deployment and the frontend `VITE_CONVEX_URL`\n- Convex Auth + Google OAuth: requires a Google OAuth Client ID and Client Secret configured in the Convex environment\n- ESV API (scripture text): requires `ESV_API_KEY` in the Convex environment\n- Vercel (optional deploy): uses `npx convex deploy` during build via `vercel.json`\n\n**Local Setup**\n\n1. Install dependencies.\n   ```bash\n   pnpm install --frozen-lockfile\n   ```\n1. Create or attach a Convex deployment.\n   ```bash\n   npx convex dev\n   ```\n1. Configure frontend environment variables.\n   Create `.env.local` with:\n   ```env\n   VITE_CONVEX_URL=https://\u003cyour-deployment\u003e.convex.cloud\n   ```\n1. Configure Convex environment variables (Dashboard or CLI).\n   Set `ESV_API_KEY` (from api.esv.org), `CONVEX_SITE_URL` (your app base URL; use `http://localhost:5173` in dev), and your Google OAuth Client ID/Secret (for Convex Auth).\n1. Run the app.\n   ```bash\n   pnpm dev\n   ```\n\n**Testing**\n\n- `pnpm test`\n\n**Notes On Import Format**\n\n- One Bible book per file, one chapter per sheet, one verse per row.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatyconnor%2Fberean","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnatyconnor%2Fberean","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatyconnor%2Fberean/lists"}