Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tmphat1312/movred
Movies recommendation web application - Advanced web development course final project
https://github.com/tmphat1312/movred
movies nextjs project recommendation
Last synced: 5 days ago
JSON representation
Movies recommendation web application - Advanced web development course final project
- Host: GitHub
- URL: https://github.com/tmphat1312/movred
- Owner: tmphat1312
- Created: 2024-12-04T06:40:20.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-01-11T12:17:26.000Z (about 1 month ago)
- Last Synced: 2025-01-11T13:27:54.175Z (about 1 month ago)
- Topics: movies, nextjs, project, recommendation
- Language: TypeScript
- Homepage: https://movred.vercel.app
- Size: 17.4 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MovRed - Movie Recommendations
Movred is a web application all about movie recommendations, make sure you don't struggle with binge-watching after visiting [`movred.vercel.app`](https://movred.vercel.app/).
## Getting Started
### Prerequisites
Manually local setup:
- [`Node.js`](https://nodejs.org/) >= 20 - to run the project.
- And `others` regular setup you could do yourself like VS Code extensions, Git, etc.
With `Docker` and [`Dev Container`](https://containers.dev/):
- Install `Dev Container` extension in VS Code (or your editor of choice).
- Open this repo in the container and you are good to go.
### Start development server
First, do whatever possible to get this repository.
Second, install dependencies:
```bash
npm install
```
Third, create `.env.local` or `.env` file and fill in all variables displayed in `.env.example`:
```bash
# clerk.com
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
NEXT_PUBLIC_CLERK_SIGN_IN_FORCE_REDIRECT_URL=/
NEXT_PUBLIC_CLERK_SIGN_UP_FORCE_REDIRECT_URL=/
TMDB_READ_ACCESS_TOKEN=
TMDB_API_KEY=
# Turso.tech
DATABASE_URL=
DATABASE_AUTH_TOKEN=
```
> **Note**: `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` and `CLERK_SECRET_KEY` are from [`clerk.com`](https://clerk.com/)
> **Note**: `DATABASE_URL` and `DATABASE_AUTH_TOKEN` are from [`turso.tech`](https://turso.tech/)
Next, make sure you run the migration command (_not migration script_):
```bash
npm run db:push
```
> **Note**: Migration scripts will be stored on `Turso` cloud.
> **Note**: You should get some data for your database before start the development server!.
Finally, run the development server:
```bash
npm run dev
```
Open [`http://localhost:3000`](http://localhost:3000) with your browser to see the result.
### Get some data to your application
First, create static data by running this command:
```bash
npm run db:port
```
> **Note**: Since other types of data are too large to include in the source, if possible please find some time to scrape data following the instruction below.
Second (optional), scrape some data from [`tmdb API`](https://developer.themoviedb.org/docs/getting-started) by running (it will take a while):
```bash
npm run db:scrape
```
> **Note**:
You can adjust how many movie records to scrape in `./src/data/__scrape-data.ts` on the two variables `fromPage` and `toPage`.
The total number of movie records is `(toPage - fromPage) * 20`. By default, `fromPage = 1` and `toPage=5`.
## Licence
No, you must not use this project for any purposes without my permission.
## 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!
To learn more about TailwindCSS, take a look at:
- [`TailwindCSS Documenation`](https://tailwindcss.com/) - learn about utility classes and functionalities of Tailwind.
- [`Tailwind Motion`](https://rombo.co/tailwind/) - beautiful animations all for free.
This project is not here without:
- [`Clerk Authentication`](https://clerk.com/) - the most comprehensive User Management Platform.
- [`Turso Database`](https://turso.tech/) - the way to go for SQLite lovers.
- [`Drizzle ORM`](https://orm.drizzle.team/) - a loving ORM for TypeScript lovers.
## Deployment
### Docker
The `Dockerfile` is already there for you to mess around with `Docker`. Alternatively, you could use my hosted version on [`tmphat1312/movred`](https://hub.docker.com/repository/docker/tmphat1312/movred/general).
> **Note**: Make sure enviroment variables are included correctly.
### 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/app/building-your-application/deploying) for more details.