{"id":23029784,"url":"https://github.com/dagmawi-22/invoice","last_synced_at":"2026-04-13T03:10:12.378Z","repository":{"id":250829319,"uuid":"835595943","full_name":"Dagmawi-22/invoice","owner":"Dagmawi-22","description":"Invoice management full-stack application with nextjs, nestjs, prisma \u0026 postgresql.","archived":false,"fork":false,"pushed_at":"2024-08-08T08:43:00.000Z","size":731,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-08T11:13:36.119Z","etag":null,"topics":["jspdf","nestjs","nextjs","nextjs14","postgresql","prisma","react","sql","swagger","swagger-ui","tailwindcss","xlsx"],"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/Dagmawi-22.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}},"created_at":"2024-07-30T06:45:53.000Z","updated_at":"2024-09-23T10:32:21.000Z","dependencies_parsed_at":"2024-08-08T10:49:05.876Z","dependency_job_id":null,"html_url":"https://github.com/Dagmawi-22/invoice","commit_stats":null,"previous_names":["dagmawi-22/invoice"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dagmawi-22%2Finvoice","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dagmawi-22%2Finvoice/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dagmawi-22%2Finvoice/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Dagmawi-22%2Finvoice/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Dagmawi-22","download_url":"https://codeload.github.com/Dagmawi-22/invoice/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246886533,"owners_count":20849883,"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":["jspdf","nestjs","nextjs","nextjs14","postgresql","prisma","react","sql","swagger","swagger-ui","tailwindcss","xlsx"],"created_at":"2024-12-15T14:17:06.204Z","updated_at":"2026-04-13T03:10:12.342Z","avatar_url":"https://github.com/Dagmawi-22.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# invoice\n\n#### A simple Next.js, Tailwind Css, Nest.js, Prisma, PostgreSql app with an invoice management features including: creating an invoice from items, updating an invoice, export invoices as excel \u0026 export an invoice as a printable Pdf.\n![image](https://github.com/user-attachments/assets/aa1961b0-733c-4dd0-b497-e3a10bc55c38)\n![image](https://github.com/user-attachments/assets/bd37be4d-2239-4674-8ff7-828332cb032e)\n![image](https://github.com/user-attachments/assets/124f39a1-6eaa-458a-a492-4654dea67b7a)\n\n\n\n\n### Tools used\n\n- Next.js (14) - for building the UI\n- Tailwind Css - for a nice looking UI without a native css\n- Nest.js - for handling the server logic\n- Prisma - for interacting with the PostgreSql database\n- PostgreSql - for storing data\n- Swagger - for documenting the Nest.js API\n- jspdf - to extract html content as printable pdf\n- xlsx - to export set of data as an excel file\n\n### How to run the app locally\n\nTo run this project locally on your machine, follow these steps:\n\n#### Prerequisites\n\nMake sure you have the following installed:\n- Node.js\n- npm or yarn\n- postgresql \n  \n\n#### Clone the Repository\n\nFirst, open you terminal window \u0026 clone this repository to your local machine:\n```bash\ngit clone https://github.com/Dagmawi-22/invoice.git\n```\nthen, cd into the server folder:\n\n```bash\ncd invoice/server\n```\nthen, install the required libraries:\n```bash\nyarn install\n```\n\nthen, customize your .env variables \u0026 run the migrations and generate your prisma client:\n```bash\nnpx prisma migrate dev\n```\n\nthen, start the app:\n```bash\nyarn start dev\n```\nthen, cd into the client folder using a new terminal window:\n\n```bash\ncd ../client\n```\nthen, install the required libraries:\n```bash\nyarn install\n```\nFinally, start the app:\n```bash\nyarn dev\n```\n\nFinally, open your preferred browser and go to http://localhost:3000 and browse through the app.\nThank you!\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdagmawi-22%2Finvoice","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdagmawi-22%2Finvoice","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdagmawi-22%2Finvoice/lists"}