Queriously

A Spring Boot-based Q&A platform for curious minds

Queriously is a minimalist Q&A application where users can ask questions, vote on content, and engage in meaningful discussions. Whether you're looking to satisfy your curiosity or share your expertise, Queriously offers a simple yet robust environment for knowledge exchange.

---

Features

Queriously lets you post questions with a title and details. Upvote, downvote, and comment to drive engaging debates 💬, with secure JWT authentication for sign-up and login 🚀.

API Documentation

➜ Self-Documenting APIs:
Leverage SpringDoc OpenAPI for easy exploration and testing of all endpoints.

---

Tech Stack

➜ Backend: Spring Boot (Java)
➜ Database: MySQL
➜ Security: JWT-based authentication
➜ API Documentation: SpringDoc OpenAPI
➜ Frontend: Next.js & shadcn/ui with Bun
➜ Build Tool: Maven

---

Why Queriously?

Queriously was born out of a desire to dive back into Spring Boot and level up my Next.js knowledge. This project is a fun experiment where I mix backend and frontend magic into one neat package. It’s a playground for trying out cool coding tricks, handling errors smartly, and building APIs that just work without all the fuss.

---

Getting Started

Prerequisites

• Java 17
• Maven
• MySQL
• Bun

---

Running the Backend

1. Clone the Repository:

   git clone https://github.com/maskedsyntax/queriously.git

2. Configure the database:
   Update your database connection details in:

   src/main/resources/application.properties
   

3. Build and Run:

   mvn spring-boot:run

4. Explore the API:
   Access the API documentation at http://localhost:8080/swagger-ui.html

Running the Frontend

1. Navigate to the Frontend Directory:

   cd frontend
   

2. Install Dependencies with Bun:

   bun install

3. Start the Dev Server:

   bun dev

4. Open the App:
   Head over to http://localhost:3000 in your browser

---

Current Status

Just starting out and will be updating details as I keep working on the project. Feedback or ideas are always welcome.

---

License

This project is licensed under the MIT License.

---

Let's Connect!

Have suggestions or spot something that could be better? Open an issue or reach out directly.