{"id":49823889,"url":"https://github.com/goww7/halal-portfolio-tracker","last_synced_at":"2026-05-13T14:04:57.802Z","repository":{"id":356357488,"uuid":"1232151276","full_name":"goww7/halal-portfolio-tracker","owner":"goww7","description":"Open-source Shariah-compliance tracker for stock portfolios. Next.js 14, one-click Vercel deploy. Powered by Halal Terminal API.","archived":false,"fork":false,"pushed_at":"2026-05-07T18:15:00.000Z","size":245,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-07T19:14:33.112Z","etag":null,"topics":["halal","halalterminal","islamic-finance","nextjs","portfolio-tracker","shariah","stocks","vercel"],"latest_commit_sha":null,"homepage":"https://halal-portfolio-tracker.vercel.app","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/goww7.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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-07T16:31:46.000Z","updated_at":"2026-05-07T18:16:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/goww7/halal-portfolio-tracker","commit_stats":null,"previous_names":["goww7/halal-portfolio-tracker"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/goww7/halal-portfolio-tracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goww7%2Fhalal-portfolio-tracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goww7%2Fhalal-portfolio-tracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goww7%2Fhalal-portfolio-tracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goww7%2Fhalal-portfolio-tracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/goww7","download_url":"https://codeload.github.com/goww7/halal-portfolio-tracker/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/goww7%2Fhalal-portfolio-tracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32985794,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"ssl_error","status_checked_at":"2026-05-13T13:14:51.610Z","response_time":115,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["halal","halalterminal","islamic-finance","nextjs","portfolio-tracker","shariah","stocks","vercel"],"created_at":"2026-05-13T14:04:54.728Z","updated_at":"2026-05-13T14:04:57.794Z","avatar_url":"https://github.com/goww7.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ch1 align=\"center\"\u003eHalal Portfolio Tracker\u003c/h1\u003e\n  \u003cp align=\"center\"\u003e\u003cstrong\u003eOpen-source Shariah-compliance tracker for your stock portfolio.\u003c/strong\u003e\u003c/p\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"MIT License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://nextjs.org\"\u003e\u003cimg src=\"https://img.shields.io/badge/Next.js-14-black?logo=next.js\" alt=\"Next.js 14\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://halalterminal.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/HalalTerminal-API-10b981\" alt=\"Halal Terminal API\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fgoww7%2Fhalal-portfolio-tracker\u0026env=HALAL_TERMINAL_API_KEY\u0026envDescription=Free%20key%20at%20halalterminal.com\u0026envLink=https%3A%2F%2Fhalalterminal.com\"\u003e\n    \u003cimg src=\"https://vercel.com/button\" alt=\"Deploy with Vercel\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\nEnter your stock holdings → get per-stock Shariah compliance, portfolio-level halal %, and purification owed. No signup, no tracking, MIT-licensed.\n\n## Features\n\n- **Per-holding badges** — ✅ Halal / ❌ Non-compliant / ⚠️ Review, with the methodology used\n- **Portfolio summary** — total value, compliant %, and estimated purification owed\n- **Live prices** — pulled from the same API call, so values reflect today\n- **Self-hostable** — Next.js 14 App Router, deploys to Vercel in 30 seconds\n- **No database, no auth** — your portfolio never leaves your browser session\n\n---\n\n## One-click deploy\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fgoww7%2Fhalal-portfolio-tracker\u0026env=HALAL_TERMINAL_API_KEY\u0026envDescription=Free%20key%20at%20halalterminal.com\u0026envLink=https%3A%2F%2Fhalalterminal.com)\n\nYou'll be prompted for `HALAL_TERMINAL_API_KEY` — grab a [free key here](https://halalterminal.com) (50 requests/month, no credit card).\n\n---\n\n## Run locally\n\n```bash\ngit clone https://github.com/goww7/halal-portfolio-tracker.git\ncd halal-portfolio-tracker\nnpm install\ncp .env.example .env.local\n# add HALAL_TERMINAL_API_KEY=ht_...\nnpm run dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000).\n\n---\n\n## How it works\n\n1. The browser posts your holdings to `/api/scan`.\n2. The route handler calls Halal Terminal's `/api/portfolio/scan` and `/api/quotes/batch` in parallel.\n3. We compute compliant %, total value, and purification owed from the merged response.\n\nThe API key stays on the server — it is never exposed to the browser.\n\n---\n\n## Configuration\n\n| Env var | Required | Description |\n|---|---|---|\n| `HALAL_TERMINAL_API_KEY` | yes | Free key at [halalterminal.com](https://halalterminal.com) |\n| `HALAL_API_BASE` | no | Override the API base URL (default: `https://api.halalterminal.com`) |\n\n---\n\n## Customizing\n\n- **Branding** — edit `app/layout.tsx` and `app/page.tsx`\n- **Methodology display** — adjust `components/ResultsTable.tsx`\n- **Fields shown** — extend `lib/halal.ts` with additional endpoints (zakat, news, ETF screening) — see the [API docs](https://halalterminal.com)\n\n---\n\n## Disclaimer\n\nAutomated screening output, **not a fatwa**. Consult a qualified scholar for personal rulings. The purification estimate uses the methodology returned by the API and is provided as a starting point.\n\n---\n\n## Related projects\n\nOther open-source tools in the Halal Terminal ecosystem:\n\n| Project | What it is |\n|---|---|\n| [**halal-discord-bot**](https://github.com/goww7/halal-discord-bot) | Discord bot — `/halal`, `/portfolio`, `/trending` slash commands |\n| [**halal-pine**](https://github.com/goww7/halal-pine) | TradingView Pine v5 indicator with daily-refreshed compliance data |\n| [**halalterminal-claude-skills**](https://github.com/goww7/halalterminal-claude-skills) | Claude Code plugin with screening skills + portfolio-builder subagent |\n| [**halalterminal-mcp**](https://github.com/goww7/halalterminal-mcp) | MCP server for any MCP-compatible client (Cursor, Cline, Codex…) |\n| [**yassir-oss**](https://github.com/goww7/yassir-oss) | Open-source ReAct agent for financial research |\n\n---\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n\u003cp align=\"center\"\u003e\u003csub\u003eBuilt on top of \u003ca href=\"https://halalterminal.com\"\u003eHalal Terminal\u003c/a\u003e.\u003c/sub\u003e\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoww7%2Fhalal-portfolio-tracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoww7%2Fhalal-portfolio-tracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoww7%2Fhalal-portfolio-tracker/lists"}