workaround/presentnow-backend
3
0
Fork 0
mirror of https://github.com/workaround-org/presentnow-backend.git synced 2026-03-16 14:21:52 +00:00
Code Issues Projects Releases Packages Wiki Activity
A web application that helps people collaboratively organize and manage gift-giving for occasions like birthday
62 commits 11 branches 0 tags 172 KiB
  • Java 100%
Find a file
Exact
Miggi 7b050f3254 ⬆ (pom): Quarkus 3.32.3
2026-03-15 20:06:20 +01:00
.github Add Dependabot configuration for Maven and GitHub Actions 2025-12-24 20:35:45 +00:00
.mvn/wrapper 🎉 Begin Present Now Backend 2025-05-25 17:54:28 +02:00
src Add Present-Ideas Counter 2025-12-04 15:09:08 +01:00
.dockerignore 🎉 Begin Present Now Backend 2025-05-25 17:54:28 +02:00
.gitignore 🎉 Begin Present Now Backend 2025-05-25 17:54:28 +02:00
LICENSE 🎉 Begin Present Now Backend 2025-05-25 17:54:28 +02:00
mvnw 🎉 Begin Present Now Backend 2025-05-25 17:54:28 +02:00
mvnw.cmd 🎉 Begin Present Now Backend 2025-05-25 17:54:28 +02:00
pom.xml ⬆ (pom): Quarkus 3.32.3 2026-03-15 20:06:20 +01:00
README.md 📝 Add meaningful README 2025-05-26 15:07:35 +02:00

README.md

PresentNow Backend

PresentNow is an open-source backend REST API (built with Java + Quarkus) for a web application that helps people collaboratively organize and manage gift-giving for occasions like birthdays.

Project Idea

Finding the right present for someone can be challenging. PresentNow aims to make gift-giving easier for everyone involved:

  • Person A (Recipient) creates or shares a wish list of presents.
  • Friends of A can view the list, choose what they want to buy, and reserve presents to avoid duplicates.
  • Friends can see who is buying which present, but Person A cannot see who is buying what—preserving the surprise!

Features

  • REST API built on Quarkus (Java)
  • User and present management
  • Present suggestion and reservation system
  • Privacy: Only friends see who is buying which present; the recipient cannot
  • Designed for easy integration with frontend clients

Tech Stack

  • Backend: Java 17+, Quarkus
  • Frontend: Vue.js (in a separate repository)
  • Database: Postgres
  • API: RESTful endpoints

Getting Started

Prerequisites

  • Java 17+ installed
  • Maven installed

Running Locally

  1. Clone the repository: 
    git clone https://github.com/vvilip/presentnow-backend.git
cd presentnow-backend
  2. Start the Quarkus development server: 
    ./mvnw quarkus:dev
  3. The API will be available at http://localhost:8080.

API Documentation

  • (Add OpenAPI/Swagger details here if available)

Frontend

A Vue.js frontend for PresentNow is developed and maintained in a separate repository.
This backend is designed to work seamlessly with the Vue.js frontend.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

This project is FOSS. See LICENSE for details.