Skip to content

Commit

Permalink
docs: add README
Browse files Browse the repository at this point in the history
  • Loading branch information
tmphat1312 committed Jun 9, 2024
1 parent 53a6771 commit 831a1b7
Showing 1 changed file with 75 additions and 36 deletions.
111 changes: 75 additions & 36 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,36 +1,75 @@
This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).

## Getting Started

First, run the development server:

```bash
npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev
```

Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.

You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.

This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font.

## Learn More

To learn more about Next.js, take a look at the following resources:

- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.

You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!

## Deploy on Vercel

The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.

Check out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.
# Thích Đọc Truyện

Software Design course final project.

Story reading web application with capabilities to search, read, and enjoy a variety types of story on the Internet (We do not steal them, we just use them as academic material).

Should there be any inconvience to you who owns a story we use, please kindly contact us for resolution.

## Team members

| Student ID | Full Name |
| ---------- | ---------------- |
| 21120502 | Trần Đức Minh |
| 21120515 | Trần Phước Nhân |
| 21120519 | Lê Thanh Phát |
| 21120521 | Nguyễn Phúc Phát |
| 21120524 | Trương Minh Phát |

## Features - Client Side

- Search for a story by name or author name from a story source
- Display details of a story (story title, description, number of chapters, genres, etc.) and chapter list
- Choose a specific chapter to read (the story content is formatted a bit)
- UI elements of the reading pad can be adjusted (background color, font family, font size)
- Chapter detail can be saved to local as PDF, EPUB, and images
- Switch the source of a chapter detail if possible
- Quickly navigate to previous, next, or a specific chapter
- Save reading history to local

## Prerequisites

1. [Node](https://nodejs.org/en) >= v18.21 (For the pnpm to work)
2. [pnpm](https://pnpm.io/) >= 9.1.0

## Getting started with this project

Create `.env` or `.env.local` file and fill all the variables (see `.env.example`)

```
# Backend API URL
NEXT_PUBLIC_API_URL=
```

Install dependencies

```bash
pnpm i
```

Spin up the `dev` server

```bash
pnpm run dev
```

You can run tests (for fun)

```bash
pnpm run test # unit & integration tests (vitest)
```

```bash
pnpm run test:ese # e2e tests (playwright)
```

## Acknowledgements

- I am, [@tmphat1312](https://github.com/tmphat1312), the only one who maintains this project will abandon it when the Software Design course ends.
- Actions in this repo are just for demo only (I just got my hands dirty with GitHub Actions)
- There was a getting started option with Docker. However I ran into problem wiht node-18 lately and decided to quit (I'm new to Docker btw)
- You can use this repo (I don't care anyway), but be careful with hidden code smell and bugs.

## License

[The Unlicense](https://choosealicense.com/licenses/unlicense/#)

0 comments on commit 831a1b7

Please sign in to comment.