{"id":50838508,"url":"https://github.com/semi-dlc/flowt-bb","last_synced_at":"2026-06-14T05:33:58.535Z","repository":{"id":318755558,"uuid":"1074326524","full_name":"semi-dlc/flowt-bb","owner":"semi-dlc","description":null,"archived":false,"fork":false,"pushed_at":"2025-10-14T22:09:20.000Z","size":1348,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-14T05:33:55.249Z","etag":null,"topics":["b2b","carpooling","logistics","ridesharing"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/semi-dlc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-10-11T15:18:57.000Z","updated_at":"2025-10-14T22:09:23.000Z","dependencies_parsed_at":"2025-10-15T05:19:37.182Z","dependency_job_id":"ecd6beca-23bd-4c16-9f04-4a3af0abd525","html_url":"https://github.com/semi-dlc/flowt-bb","commit_stats":null,"previous_names":["semi-dlc/flowt-bb"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/semi-dlc/flowt-bb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semi-dlc%2Fflowt-bb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semi-dlc%2Fflowt-bb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semi-dlc%2Fflowt-bb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semi-dlc%2Fflowt-bb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/semi-dlc","download_url":"https://codeload.github.com/semi-dlc/flowt-bb/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/semi-dlc%2Fflowt-bb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34310801,"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-14T02:00:07.365Z","response_time":62,"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":["b2b","carpooling","logistics","ridesharing"],"created_at":"2026-06-14T05:33:57.968Z","updated_at":"2026-06-14T05:33:58.521Z","avatar_url":"https://github.com/semi-dlc.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FLOWT – Sustainable Freight Ridesharing\nFLOWT matches unused trucking capacity with shippers that need space. The platform combines a marketplace for offers and requests with an agent that coordinates live supply and demand, helping logistics teams collaborate, and filling empty miles. \n\nFlowt is an experiment to determine the state of vibe-coding tools.\nIt is noted that while web applications are mostly created fine, the problems arising in the backend are hard to debug. Furthermore, the inherent security threats in the AI-edited code are interesting to detect.\n\nThe project is not be developed any further, and I distance myself from its sourcecode.\n\n\n## TODO\n- Connect to OSM to calculate route and get coordinates of places when entering data.\n- Connect app to invoices and Bill of Loadings.\n\n## Product Highlights\n- B2B freight marketplace where carriers publish open capacity and shippers post their loads.\n- Profile onboarding for logistics companies through Supabase.\n- Rich offer/request management with validation for weights, routes, pricing, and cargo types.\n- Real-time AI assistant (`supabase/functions/freight-ai-agent`) that answers route questions and recommends matches using database context.\n- Developer control for tuning AI models, temperature, prompts, and token budgets.\n\n## Tech Stack\n- React 18 + Vite + TypeScript for the SPA.\n- Tailwind CSS + shadcn/ui for the glassmorphism UI.\n- Supabase (database, Auth, Row Level Security policies, Edge Functions).\n- Deno Edge Function calling the Lovable AI gateway for freight-specific reasoning.\n\n## Prerequisites\n- Node.js 20+ and npm.\n- Supabase account \u0026 CLI (to run the database locally or manage migrations).\n\n## Getting Started\n```bash\ngit clone \u003crepo\u003e\ncd flowt-bb\nnpm install\n```\n\n1. Create a Supabase project (or run `supabase start` locally).\n2. Apply database schema:\n   ```bash\n   supabase db push\n   ```\n   This seeds enums (`shipment_status`, `cargo_type`), tables (`profiles`, `shipment_offers`, `shipment_requests`, `bookings`), indexes, and RLS policies.\n3. Copy your environment variables into `.env` (or `.env.local`):\n   ```bash\n   VITE_SUPABASE_URL=\u003cyour-supabase-url\u003e\n   VITE_SUPABASE_PUBLISHABLE_KEY=\u003cyour-anon-or-public-key\u003e\n   ```\n4. Start the web app:\n   ```bash\n   npm run dev\n   ```\n   Visit the printed URL, create an account, and complete your company profile before posting offers or requests.\n\n## AI Agent Configuration\nThe AI chat panel calls the Supabase Edge Function `freight-ai-agent`. Configure its secrets so it can reach Supabase and the Lovable AI gateway:\n\n```bash\nsupabase secrets set --project-ref \u003cref\u003e \\\n  LOVABLE_API_KEY=\u003clovable-api-key\u003e \\\n  SUPABASE_URL=\u003cyour-supabase-url\u003e \\\n  SUPABASE_SERVICE_ROLE_KEY=\u003cservice-role-key\u003e\n```\n\nDeploy the function with:\n```bash\nsupabase functions deploy freight-ai-agent\n```\n\nThe assistant automatically pulls the latest `shipment_offers`, `shipment_requests`, and `bookings` to provide contextual recommendations.\n\n## Project Structure\n```\nflowt-bb/\n├─ src/pages                # Auth, dashboard, 404 routes\n├─ src/components           # Offer/request lists, dialogs, AI chat UI\n├─ src/integrations         # Supabase client \u0026 generated types\n├─ supabase/migrations      # SQL schema, RLS policies, indexes\n└─ supabase/functions       # Deno edge functions (freight AI agent)\n```\n\n## Useful Scripts\n- `npm run dev` – start the local dev server.\n- `npm run build` – production build.\n- `npm run lint` – run ESLint checks.\n\n## Next Steps\n- Extend booking workflows so matched offers/requests transition through `matched → in_transit → completed`.\n- Add analytics dashboards to surface fill rates and revenue impact.\n- Integrate notifications (email/SMS) for new matches or AI recommendations.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsemi-dlc%2Fflowt-bb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsemi-dlc%2Fflowt-bb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsemi-dlc%2Fflowt-bb/lists"}