{"id":31011938,"url":"https://github.com/jane-does-coding/citrusai","last_synced_at":"2025-09-13T05:14:57.905Z","repository":{"id":311329521,"uuid":"1043406835","full_name":"jane-does-coding/citrusai","owner":"jane-does-coding","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-01T23:36:03.000Z","size":200,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-02T01:18:05.578Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://citrusai.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/jane-does-coding.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":"2025-08-23T19:33:57.000Z","updated_at":"2025-09-01T23:36:06.000Z","dependencies_parsed_at":"2025-08-24T08:36:05.934Z","dependency_job_id":null,"html_url":"https://github.com/jane-does-coding/citrusai","commit_stats":null,"previous_names":["jane-does-coding/citrusai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jane-does-coding/citrusai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jane-does-coding%2Fcitrusai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jane-does-coding%2Fcitrusai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jane-does-coding%2Fcitrusai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jane-does-coding%2Fcitrusai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jane-does-coding","download_url":"https://codeload.github.com/jane-does-coding/citrusai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jane-does-coding%2Fcitrusai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274920110,"owners_count":25373954,"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","status":"online","status_checked_at":"2025-09-13T02:00:10.085Z","response_time":70,"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":[],"created_at":"2025-09-13T05:14:52.927Z","updated_at":"2025-09-13T05:14:57.895Z","avatar_url":"https://github.com/jane-does-coding.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Citrus.ai\n\nCitrus.ai is a SaaS platform that empowers HR teams to collect honest, private feedback through exit interviews.  \nWhen employees leave, HR managers can generate tailored exit interview forms, share them securely, and receive insights powered by AI.\n\nSomething i struggled with while creating that project, is the form creation logic, specifically for select and radio inputs. Those inputs require to be able to add multiple options to what to select, while regular text inputs don't need that, and I didn't want to create seperate schema and api for it, so I was struggling creating that logic, and I chose to add another fiels called options field, which can be empty in case the input is text or number.\n\n## Key Features\n\n- HR creates custom exit interview forms (questions, labels, placeholders).\n- Receiver (employee) fills out the form anonymously/privately via a unique link.\n- Responses are stored securely — only the HR creator can access them.\n- AI insights help HR identify recurring themes in feedback.\n- Notification system keeps HR updated when interviews are completed.\n\n## Tech Stack\n\n- **Next.js 13+ App Router**\n- **Prisma ORM** with MongoDB\n- **TailwindCSS** for styling\n- **TypeScript**\n- Optional integrations: AI/NLP for insights, email delivery for sharing links.\n\n# Citrus.ai Workflow\n\n## 1. HR User\n\n1. Logs in / creates an account.\n2. Creates an **Exit Interview**:\n   - Adds receiver name + email.\n   - Defines interview fields (label, placeholder).\n   - Gets a unique link for the interview.\n3. Shares the link with the receiver.\n4. Receives a notification once the interview is completed.\n5. Views responses and AI-generated insights.\n\n## 2. Receiver (Employee)\n\n1. Opens interview link (no login required).\n2. Sees form fields defined by HR.\n3. Fills out and submits their answers.\n4. Submission is stored in the database, linked to the interview.\n\n## 3. Backend System\n\n- Stores interviews, fields, and responses.\n- Generates notifications for HR.\n- Tracks interview completion status (`isCompleted`).\n- Supports AI analysis on submitted feedback.\n\n## Setup\n\n### 1. Clone the repo\n\n```bash\ngit clone https://github.com/jane-does-coding/citrusai\ncd citrusai\n```\n\n### 2. Install the dependencies\n\n```bash\nnpm i\n```\n\n### 3. Configure .env\n\n```bash\nDATABASE_URL=\"your mongodb\"\nNEXTAUTH_SECRET=\"random-secret\"\n```\n\n### 4. Setup Prisma\n\n```bash\nnpx prisma generate\n```\n\n### 4. Run the project\n\n```bash\nnpm run dev\n```\n\n[![Athena Award Badge](https://img.shields.io/endpoint?url=https%3A%2F%2Faward.athena.hackclub.com%2Fapi%2Fbadge)](https://award.athena.hackclub.com?utm_source=readme)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjane-does-coding%2Fcitrusai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjane-does-coding%2Fcitrusai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjane-does-coding%2Fcitrusai/lists"}