Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/maskedsyntax/queriously
A minimalist Q&A app built with Spring Boot, Next.js, and Bun
https://github.com/maskedsyntax/queriously
ask blog bun full-stack java java-17 maven nextjs qna spring-boot typescript vercel
Last synced: 3 days ago
JSON representation
A minimalist Q&A app built with Spring Boot, Next.js, and Bun
- Host: GitHub
- URL: https://github.com/maskedsyntax/queriously
- Owner: MaskedSyntax
- License: mit
- Created: 2024-12-11T17:46:25.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-02-11T18:01:23.000Z (3 days ago)
- Last Synced: 2025-02-11T18:41:08.098Z (3 days ago)
- Topics: ask, blog, bun, full-stack, java, java-17, maven, nextjs, qna, spring-boot, typescript, vercel
- Language: Java
- Homepage:
- Size: 67.4 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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:**
```bash
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:**
```bash
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:**
```bash
bun install
```
3. **Start the Dev Server:**
```bash
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.