Skip to content

Repository files navigation

TezTok Logo

scroll theses instead of reels.


Overview

TezTok transforms the often mundane task of browsing academic theses into an engaging, immersive experience. What started clearly as a joke actually turned into a usable, mildly-interesting web app. Combining a social media styled vertical feed with powerful scraping for academic research to your fingertips.


App Gallery



Desktop view optimized for widescreen devices.


Setup & Development

Prerequisites

  • Node.js (>= 20.x)
  • npm or yarn

Installation

# Clone the repository
git clone https://github.com/yourusername/yoktez-tiktok.git

# Install dependencies
npm install

# Run in development mode (Simultaneous Client & Server)
npm run dev

Environment Configuration

Create a .env file in the root directory:

VITE_YOKTEZ_API_BASE_URL=http://localhost:3001
OPENAI_API_KEY=your_openai_key
VITE_UNSPLASH_ACCESS_KEY=your_unsplash_key

Deployment

Frontend (Vercel)

The client is ready for Vercel deployment with included vercel.json configurations.

Mobile (Capacitor)

# Sync with native platforms
npm run cap:sync

# Open in IDE
npm run cap:open:ios
npm run cap:open:android

Developed with ❤️ for the academic community.

About

A mobile-first interface for discovering academic papers through a vertical, scroll-based feed.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages