poprink nano

minimalist web interface for poprink

features

• dynamic time greetings
• live search suggestions
• custom html5 video player
• range request proxy for video streaming
• 16 languages translation support

commands

running locally

you can run the project locally using either pnpm or bun:

pnpm

install dependencies:

pnpm install

configure application:

node setup.js

compile application:

pnpm build

run local development server:

pnpm dev

bun

install dependencies:

bun install

configure application:

node setup.js

compile application:

bun run build

run local development server:

bun run dev

docker

host with docker (no coding needed)

pull and run the pre-built image directly:

docker pull ghcr.io/mohameodo/nano:latest
docker run -p 3000:3000 -e SITE_NAME="my nano site" ghcr.io/mohameodo/nano:latest

build from source

docker build -t nano .
docker run -p 3000:3000 -e SITE_NAME="my nano site" nano

environment variables

you can customize the application at runtime using environment variables:

• TMDB_API_KEY - tmdb api key (optional, has built-in fallback)
• TMDB_ACCESS_TOKEN - tmdb access token (optional)
• DATABASE_URL - postgres database connection string (optional, defaults to local json database)
• DATABASE_TYPE - postgres or json (defaults to json or auto-detects from database url)
• SITE_NAME - name of your site (default poprink)
• THEME_HUE - default accent color hue 0-360 (default 310)
• THEME_MODE - default color scheme dark or light (default dark)
• THEME_BG_STYLE - background texture pattern style dots, lines, thin-lines, text, grain, or none (default none)
• THEME_CUSTOM_BG - custom background image/pattern URL
• GREETING_STYLE - main landing greeting style slogans, logo, icon, gif, or logo-and-icon (default slogans)
• CUSTOM_ICON - custom icon identifier tv, film, play, video, ticket, camera, gamepad, headphones, disc, or media
• CUSTOM_GIF - custom logo GIF image URL
• HEADER_SHOW_THEME_TOGGLE - show theme mode toggle in header true or false (default true)
• HEADER_SHOW_COLOR_PICKER - show color hue picker in header true or false (default true)
• HEADER_SHOW_LANG_SELECTOR - show language selector in header true or false (default true)
• METADATA_TITLE - browser window title (default poprink nano)
• METADATA_DESCRIPTION - meta description for seo
• DEFAULT_LOCALE - default interface language code (default en)
• SHOW_WATERMARKS - show matrix overlay grid background true or false (default true)
• SHOW_TRENDING - show trending movies on homepage true or false (default false)
• SHOW_QUICK_TAGS - show genres tags true or false (default false)
• ENABLE_AUTH - enable simple local login page true or false (default false)
• AUTOPLAY - start video automatically on load true or false (default true)
• USE_VIDSTACK - use advanced custom player controls true or false (default true)