An open API service indexing awesome lists of open source software.

https://github.com/srteerra/keno

An experimental app that provides practical productivity tips for developers generated with OpenAI
https://github.com/srteerra/keno

ai artificial-intelligence contributions-welcome first-pull-request nextjs open-source openai productivity typescript

Last synced: about 2 months ago
JSON representation

An experimental app that provides practical productivity tips for developers generated with OpenAI

Awesome Lists containing this project

README

          

# ๐ŸŽฏ Keno

**Daily productivity tips for developers, powered by AI**

_Work smarter. Ship faster. Learn every day._

[![Next.js](https://img.shields.io/badge/Next.js-15-black?style=flat-square&logo=next.js)](https://nextjs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
[![Tailwind CSS](https://img.shields.io/badge/Tailwind-CSS-06B6D4?style=flat-square&logo=tailwindcss&logoColor=white)](https://tailwindcss.com/)
[![Vercel](https://img.shields.io/badge/Deployed%20on-Vercel-black?style=flat-square&logo=vercel)](https://vercel.com/)

[Live Demo](https://keno-nine.vercel.app/) ยท [Report a Bug](https://github.com/srteerra/keno/issues) ยท [Request Feature](https://github.com/srteerra/keno/issues)

---

## ๐Ÿ“Œ What is Keno?

Keno is a web app that delivers **fresh, AI-generated productivity tips** every day โ€” tailored for developers. No fluff. Just practical, copy-paste-ready advice across the tools you already use.

> ๐Ÿ’ก Think of it as a daily standup with a senior dev who always has a useful trick up their sleeve.

---

## โœจ Features at a Glance

| Feature | Description |
| -------------------------- | -------------------------------------------------- |
| ๐Ÿค– **AI-Powered Tips** | Fresh insights generated daily via OpenAI |
| ๐Ÿ—‚๏ธ **6 Categories** | Git ยท Terminal ยท Editor ยท React ยท CSS ยท TypeScript |
| ๐ŸŒ™ **Dark Mode** | Easy on the eyes, day or night |
| ๐Ÿ“ฑ **Responsive** | Works on desktop, tablet, and mobile |
| ๐Ÿ–๏ธ **Syntax Highlighting** | Code snippets rendered with Prism.js |
| ๐Ÿ”„ **Daily Refresh** | New content every day to keep learning |

---

## ๐Ÿš€ Getting Started

### Prerequisites

Make sure you have the following installed:

- **Node.js** `>= 20.0.0` โ€” [Download](https://nodejs.org/)
- A package manager: `npm`, `yarn`, `pnpm`, or `bun`

### 1 ยท Clone & Install

```bash
git clone https://github.com/srteerra/keno.git
cd keno
npm install
```

### 2 ยท Set Up Environment Variables

Create a `.env.local` file in the project root:

```env
# .env.local
NEXT_PUBLIC_API_URL=https://your-api-url.com/api
```

> โš ๏ธ Without this variable, the app won't be able to fetch AI-generated tips.

### 3 ยท Run the Dev Server

```bash
npm run dev
```

Open [http://localhost:3000](http://localhost:3000) โ€” you're good to go! ๐ŸŽ‰

---

## ๐Ÿ› ๏ธ Tech Stack

```
keno/
โ”œโ”€โ”€ Framework โ†’ Next.js 15 (App Router)
โ”œโ”€โ”€ Language โ†’ TypeScript 5.x
โ”œโ”€โ”€ Styling โ†’ Tailwind CSS
โ”œโ”€โ”€ UI Components โ†’ Radix UI / shadcn/ui
โ”œโ”€โ”€ Markdown โ†’ react-markdown
โ”œโ”€โ”€ Highlighting โ†’ Prism.js
โ”œโ”€โ”€ Icons โ†’ Lucide Icons
โ””โ”€โ”€ Deployment โ†’ Vercel
```

---

## ๐Ÿ“– Available Scripts

```bash
npm run dev # Start development server (localhost:3000)
npm run build # Build for production
npm run start # Start production server
npm run lint # Lint with ESLint
npm run type-check # Run TypeScript type check
```

---

## ๐Ÿ“ Project Structure

```
keno/
โ”œโ”€โ”€ app/ # Next.js App Router pages & layouts
โ”œโ”€โ”€ components/ # Reusable UI components
โ”œโ”€โ”€ lib/ # Utilities and helpers
โ”œโ”€โ”€ public/ # Static assets
โ””โ”€โ”€ .env.local # Environment variables (create this!)
```

---

## ๐Ÿค Contributing

Contributions, issues, and feature requests are welcome!

1. Fork the repository
2. Create your branch: `git checkout -b feature/my-feature`
3. Commit your changes: `git commit -m 'Add my feature'`
4. Push to your branch: `git push origin feature/my-feature`
5. Open a Pull Request

---

## ๐Ÿ™ Built With

- [Next.js](https://nextjs.org/) โ€” React framework
- [OpenAI](https://openai.com/) โ€” AI model provider
- [Vercel](https://vercel.com/) โ€” Hosting & deployment
- [shadcn/ui](https://ui.shadcn.com/) โ€” UI component system

---

โญ **Found this useful? Give it a star!** โญ

_Made with โค๏ธ by developers, for developers_