https://github.com/dagmawi-22/invoice

Invoice management full-stack application with nextjs, nestjs, prisma & postgresql.
https://github.com/dagmawi-22/invoice

jspdf nestjs nextjs nextjs14 postgresql prisma react sql swagger swagger-ui tailwindcss xlsx

Last synced: 12 days ago
JSON representation

Invoice management full-stack application with nextjs, nestjs, prisma & postgresql.

• Host: GitHub
• URL: https://github.com/dagmawi-22/invoice
• Owner: Dagmawi-22
• Created: 2024-07-30T06:45:53.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2024-08-08T08:43:00.000Z (5 months ago)
• Last Synced: 2024-08-09T10:56:27.677Z (5 months ago)
• Topics: jspdf, nestjs, nextjs, nextjs14, postgresql, prisma, react, sql, swagger, swagger-ui, tailwindcss, xlsx
• Language: TypeScript
• Homepage: http://168.119.122.154:5000/
• Size: 714 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# invoice

#### 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 & export an invoice as a printable Pdf.

![image](https://github.com/user-attachments/assets/aa1961b0-733c-4dd0-b497-e3a10bc55c38)

![image](https://github.com/user-attachments/assets/bd37be4d-2239-4674-8ff7-828332cb032e)

![image](https://github.com/user-attachments/assets/124f39a1-6eaa-458a-a492-4654dea67b7a)

### Tools used

- Next.js (14) - for building the UI

- Tailwind Css - for a nice looking UI without a native css

- Nest.js - for handling the server logic

- Prisma - for interacting with the PostgreSql database

- PostgreSql - for storing data

- Swagger - for documenting the Nest.js API

- jspdf - to extract html content as printable pdf

- xlsx - to export set of data as an excel file

### How to run the app locally

To run this project locally on your machine, follow these steps:

#### Prerequisites

Make sure you have the following installed:

- Node.js

- npm or yarn

- postgresql 

  

#### Clone the Repository

First, open you terminal window & clone this repository to your local machine:

```bash

git clone https://github.com/Dagmawi-22/invoice.git

```

then, cd into the server folder:

```bash

cd invoice/server

```

then, install the required libraries:

```bash

yarn install

```

then, customize your .env variables & run the migrations and generate your prisma client:

```bash

npx prisma migrate dev

```

then, start the app:

```bash

yarn start dev

```

then, cd into the client folder using a new terminal window:

```bash

cd ../client

```

then, install the required libraries:

```bash

yarn install

```

Finally, start the app:

```bash

yarn dev

```

Finally, open your preferred browser and go to http://localhost:3000 and browse through the app.

Thank you!