{"id":24935181,"url":"https://github.com/che3sy/face-it","last_synced_at":"2026-04-30T00:31:14.445Z","repository":{"id":274956313,"uuid":"915081598","full_name":"che3sy/Face-It","owner":"che3sy","description":"Face-It, a website made to mange student finances","archived":false,"fork":false,"pushed_at":"2025-03-21T09:32:38.000Z","size":1075,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-28T15:15:08.834Z","etag":null,"topics":["fbla-coding-and-programming","finance","finance-management","gemini-api","nuxt3","shadcn-vue","supabase","tailwindcss"],"latest_commit_sha":null,"homepage":"https://face-it.pages.dev/","language":"Vue","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/che3sy.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}},"created_at":"2025-01-10T23:28:57.000Z","updated_at":"2025-03-21T09:32:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"b926cbc2-12a2-4f87-9a79-44b8fd52ea04","html_url":"https://github.com/che3sy/Face-It","commit_stats":null,"previous_names":["che3sy/face-it"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/che3sy%2FFace-It","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/che3sy%2FFace-It/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/che3sy%2FFace-It/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/che3sy%2FFace-It/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/che3sy","download_url":"https://codeload.github.com/che3sy/Face-It/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246049631,"owners_count":20715511,"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":["fbla-coding-and-programming","finance","finance-management","gemini-api","nuxt3","shadcn-vue","supabase","tailwindcss"],"created_at":"2025-02-02T15:21:45.042Z","updated_at":"2026-04-30T00:31:14.394Z","avatar_url":"https://github.com/che3sy.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Face-It\n\n## Face It, Time to Master Your Money\n\n**Face-It** is a comprehensive financial management application designed to help users manage and track their finances effectively. The application provides tools for visualizing income and expenses, categorizing transactions, predicting future financial trends, and generating financial reports.\n\n**Hosted URL**: [https://face-it.pages.dev/](https://face-it.pages.dev/)\n\n## Installation Instructions\n\nTo set up and run the Face-It application, follow these steps:\n\n1. **Clone the repository**:\n   ```bash\n   git clone https://github.com/yourusername/face-it.git\n   cd face-it\n   ```\n2. **Install dependencies**:\n\n   ```bash\n   # npm\n   npm install\n\n   # pnpm\n   pnpm install\n\n   # yarn\n   yarn install\n\n   # bun\n   bun install\n   ```\n\n3. **Run the development server:**:\n\n   ```bash\n   # npm\n   npm run dev\n\n   # pnpm\n   pnpm dev\n\n   # yarn\n   yarn dev\n\n   # bun\n   bun run dev\n   ```\n\n4. **Build the application for production:**:\n\n   ```bash\n   # npm\n   npm run build\n\n   # pnpm\n   pnpm build\n\n   # yarn\n   yarn build\n\n   # bun\n   bun run build\n   ```\n\n5. **Preview the production build**:\n\n   ```bash\n   # npm\n   npm run preview\n\n   # pnpm\n   pnpm preview\n\n   # yarn\n   yarn preview\n\n   # bun\n   bun run preview\n   ```\n\n#### Usage Instructions\n\n1. **Dashboard**: View an overview of your financial status, including income, expenses, and balance.\n\n2. **Transactions**: Add, edit, and delete transactions. Categorize them as income or expenses.\n\n3. **Report**: Generate and download financial reports in PDF format.\n\n4. **Analytics**: Visualize your financial data using various charts (line charts, bar charts, donut charts).\n   - **AI Tips**: Get AI-generated tips on how to save more money based on your financial data.\n\n#### Code Structure\n\n- **components/**: Contains Vue components used throughout the application.\n- **pages/**: Contains Vue pages that define the routes of the application.\n- **assets/css/**: Contains the main CSS file with Tailwind CSS configurations.\n- **composables/**: Contains reusable logic and functions.\n- **public/**: Contains static assets like images and icons.\n- **server/**: Contains server-side code and configurations.\n- **nuxt.config.js**: Nuxt.js configuration file.\n- **tailwind.config.js**: Tailwind CSS configuration file.\n\n#### External Libraries or Frameworks\n\n- **Nuxt.js**: Framework for building Vue.js applications.\n- **Tailwind CSS**: Utility-first CSS framework for styling.\n- **Pinia**: State management library for Vue.js.\n- **VueUse**: Collection of essential Vue Composition Utilities.\n- **@google/generative-ai**: Library for integrating Google Generative AI.\n- **@tanstack/vue-table**: Table component for Vue.js.\n- **@vee-validate/zod**: Validation library for Vue.js.\n- **@unovis/ts** and **@unovis/vue**: Libraries for data visualization.\n- **shadcn**: A library for building accessible and customizable UI components.\n\n#### Known Issues or Limitations\n\n- The AI service may occasionally be unavailable due to server overload. If this happens, the application will display a message indicating that the AI is unavailable.\n- Some features may not be fully optimized for mobile devices.\n\n#### Contact Information\n\n- **Name**: Ibrahim Afzal\n- **Email**: ibrahim.afzal.c740@gmail.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fche3sy%2Fface-it","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fche3sy%2Fface-it","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fche3sy%2Fface-it/lists"}