https://github.com/jplaskota/kepler
Kepler is a web application for saving movies and series for later
https://github.com/jplaskota/kepler
bun drizzle-orm hono kinde-auth lodash react shadcn-ui supabase tailwind tanstack-query tanstack-router vite zod
Last synced: 3 months ago
JSON representation
Kepler is a web application for saving movies and series for later
- Host: GitHub
- URL: https://github.com/jplaskota/kepler
- Owner: jplaskota
- License: gpl-3.0
- Created: 2024-01-04T15:12:51.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-10T22:32:15.000Z (over 1 year ago)
- Last Synced: 2025-03-10T23:28:49.888Z (over 1 year ago)
- Topics: bun, drizzle-orm, hono, kinde-auth, lodash, react, shadcn-ui, supabase, tailwind, tanstack-query, tanstack-router, vite, zod
- Language: TypeScript
- Homepage:
- Size: 3.66 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌌 Kepler
Kepler is a web application for saving movies and series for later. Keep track of your watchlist and never lose sight of the content you want to watch!
## 🚀 Features
- Search for movies and TV series
- Save content to your watchlist
- Get detailed information about movies and series
- User authentication and personalized lists
## 📸 Screenshots
Here are some screenshots of the application:



## 🛠️ Tech Stack
### Frontend
- React with TypeScript
- Vite
- TanStack Router
- Tailwind CSS
- Shadcn/ui
### Backend
- Bun
- Hono
- Drizzle ORM
- PostgreSQL
- Supabase
### Authentication
- Kinde Auth
## 🏗️ Project Structure
```
├── client/ # Frontend application
└── server/ # Backend application
```
Detailed documentation for each part can be found in their respective directories:
- [Client Documentation](./client/README.md)
- [Server Documentation](./server/README.md)
## 🚦 Getting Started
### Prerequisites
- [Bun](https://bun.sh/) installed
- PostgreSQL database
- Kinde Auth account
- TMDB and OMDB API keys
### Development Environment
1. Clone the repository
```bash
git clone https://github.com/your-username/kepler.git
cd kepler
```
2. Configure environment variables
```bash
cd server
cp .env.example .env
```
Edit the `.env` file and fill in your credentials for:
- Database connection
- Kinde Auth
- TMDB and OMDB API keys
3. Start the frontend development server
```bash
cd client
bun install
bun dev # Runs on localhost:5173
```
4. Start the backend development server
```bash
cd server
bun install
bun dev # Runs on localhost:3000
```
### Production Environment
To run the application in production mode:
```bash
cd server
bun install
bun dev # Runs on localhost:3000
```
## 📝 License
This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.
## 🤝 Contributing
I welcome your input! I aim to make contributing to Kepler as easy and transparent as possible, whether it's:
- Reporting a bug
- Discussing the current state of the code
- Submitting a fix
- Proposing new features
- Becoming a maintainer
All contributions are welcome! Please feel free to open issues and submit pull requests.