Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add readme #5

Merged
merged 2 commits into from
Mar 21, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
62 changes: 62 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
# English cards

<img src="./img/logo.png" alt="English Cards">

# Idea

Many people try to learn and remember new English words but forget about them too fast. This application aims to help
people use a deck of cards on different topics. This can be a custom deck that users created or generated by AI on
specific topics. Users will have the ability to use
interval repetition to recall learnt words.

# Application part

This repository is responsible for the main backend part that will include main items for the system.

### Requirements

- **Java**: Version 17.
- **Gradle**
- **Docker**
- **PostgreSQL**

### Getting Started

Follow these steps to get started with the project:

1. **Clone this repository**

```bash
git clone https://github.com/Pan14ek/english-cards.git
cd english-cards
```

2. **Configure the database configuration**
<p>Open the <b>src/main/resources/application.properties</b> file and fill required fields to work with DB locally.</p>

```properties
spring.datasource.url=
spring.datasource.username=
spring.datasource.password=
```

**Hint**
<p>You can run PostgreSQL using Docker:

```bash
docker run --name some-postgres -e POSTGRES_PASSWORD=ju23pass -p 5432:5432 -d postgres
```


3. **Build the project**

```bash
./gradlew clean build
```

4. **Run the application**

1. Open the <b>src/main/java/EnglishCardsApplication.java</b> file
2. Run the main method.

5. **Enjoy :)**
Binary file added img/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading