Norish is a real-time, household-first recipe app for planning meals, sharing groceries, and cooking together.

• Norish
  • Table of Contents
  • Vision
  • Why Norish
  • Core Features
  • Deploying
    • Minimal Docker Compose
    • First-User Setup
  • Admin Settings
  • Environment Variables
    • Required by schema
    • Commonly set in production
    • Optional general Runtime
    • Optional auth setup
    • Optional OIDC Claim Mapping
    • Optional AI Provider
    • Optional Video + Transcription
    • Optional (Parsing + Content Detection)
    • Optional (Scheduler + Upload Limits)
    • Optional (Internationalization)
  • Local Development
    • Development Commands
  • Tech Stack
    • Frontend
    • Backend
    • Database
    • AI and Processing
    • Testing and Tooling
  • License
  • FOSS Alternatives
• Nora

The vision for Norish is a shared recipe app built for friends, families, and households that want to share a recipe catalogue.

The name comes from Nora (our dog) + dish. Coincidentally, it also sounds like "nourish".

Norish started because we wanted a cooking app that felt intuitive and easy to use. The existing apps we tested sadly did not meet our requirements in ease of use and aestethics.

Norish is intentionally minimal. It focuses on practical day-to-day use.

• Easy recipe import from URL, with AI fallback if configured.
• Video recipe import from YouTube Shorts, Instagram Reels, TikTok, and more (requires AI provider).
• Image recipe import from screenshots/photos of recipes (requires AI provider).
• Nutritional information generation (requires AI provider).
• Allergy detection and warnings for recipe ingredients (detection requires AI provider).
• Unit conversion metric <-> US (requires AI provider).
• Recurring groceries via NLP or manual setup.
• Real-time sync of recipes, groceries, and meal planning data.
• Households with shared groceries and planning.
• CalDAV sync for calendar integration.
• Mobile-first design with light/dark mode support.
• Authentication options: OIDC, OAuth providers, and first-time password auth fallback.
• Admin settings UI for runtime configuration.
• Permission policies for recipe visibility/edit/delete scopes.
• Internationalization (i18n) currently supporting EN, NL, DE, FR, ES, RU, KO, PL, and DA

Note: AI feature speed can vary by provider, model, and region.

For a full template, see docker-compose.example.yml.

services: norish: image: norishapp/norish:latest container_name: norish-app restart: always ports: - "3000:3000" user: "1000:1000" volumes: - norish_data:/app/uploads environment: AUTH_URL: http://norish.example.com DATABASE_URL: postgres://postgres:norish@db:5432/norish MASTER_KEY: <32-byte-base64-key> # openssl rand -base64 32 CHROME_WS_ENDPOINT: ws://chrome-headless:3000 REDIS_URL: redis://redis:6379 UPLOADS_DIR: /app/uploads # Optional # NEXT_PUBLIC_LOG_LEVEL: info # TRUSTED_ORIGINS: http://192.168.1.100:3000,https://norish.example.com # YT_DLP_BIN_DIR: /app/bin # First-user auth setup (choose one) # OIDC_NAME: NoraId # OIDC_ISSUER: https://auth.example.com # OIDC_CLIENT_ID: <client-id> # OIDC_CLIENT_SECRET: <client-secret> # OIDC_WELLKNOWN: https://auth.example.com/.well-known/openid-configuration # GITHUB_CLIENT_ID: <github-client-id> # GITHUB_CLIENT_SECRET: <github-client-secret> # GOOGLE_CLIENT_ID: <google-client-id> # GOOGLE_CLIENT_SECRET: <google-client-secret> healthcheck: test: [ "CMD-SHELL", 'node -e "require(''http'').get(''http://localhost:3000/api/health'', r => process.exit(r.statusCode===200?0:1))"', ] interval: 1m timeout: 15s retries: 3 start_period: 1m depends_on: - db - redis db: image: postgres:17-alpine container_name: norish-db restart: unless-stopped environment: POSTGRES_USER: postgres POSTGRES_PASSWORD: norish POSTGRES_DB: norish volumes: - db_data:/var/lib/postgresql/data chrome-headless: image: zenika/alpine-chrome:latest container_name: chrome-headless restart: unless-stopped command: - "--no-sandbox" - "--disable-gpu" - "--disable-dev-shm-usage" - "--remote-debugging-address=0.0.0.0" - "--remote-debugging-port=3000" - "--headless" redis: image: redis:8.4.0 container_name: norish-redis restart: unless-stopped volumes: - redis_data:/data volumes: db_data: norish_data: redis_data:

The first user to sign in becomes server owner + server admin. After first sign-in:

• User registration is disabled automatically.
• Ongoing server settings are managed in Settings -> Admin.

Server owners/admins can manage:

• Registration policy.
• Permission policies for recipe view/edit/delete.
• Auth providers (OIDC, GitHub, Google).
• OIDC claim mapping for admin role assignment + household auto-join.
• Content detection settings (units, content indicators, recurrence config).
• AI + video processing settings.
• System scheduler and server restart actions.

env-config-server.ts is the source of truth for runtime env vars.

By default, set DATABASE_URL directly.

If DATABASE_URL is not set, Norish composes it from optional component vars. Use this only if you intentionally prefer split variables over a single URL.

For local development, the default setup is still a direct URL in .env.local, typically: DATABASE_URL=postgres://postgres:norish@localhost:5432/norish

When no component vars are set, the fallback URL is: postgresql://postgres:norish@localhost:5432/norish

Configure one provider for initial sign-in; after that, use Settings -> Admin.

Provider callback URLs:

These are only used when claim mapping is enabled.

# Clone the repository git clone https://github.com/norish-recipes/norish.git cd norish # Install dependencies pnpm install # Create your environment file cp .env.example .env.local # Start required services (Postgres, Redis, Chrome) pnpm run docker:up # Run the web app pnpm run dev # Run the mobile app (Expo) pnpm run dev:mobile

• Web: Next.js 16 App Router, React 19, HeroUI v2, Tailwind CSS v4, Motion, TanStack Query
• Mobile: Expo SDK 55, Expo Router, React Native 0.83, React 19, HeroUI Native v1 RC3, Uniwind, Tailwind CSS v4 theme tokens

• Node.js custom server
• tRPC
• Better Auth
• Pino
• Redis
• BullMQ

• PostgreSQL
• Drizzle ORM

• OpenAI SDK
• Playwright
• yt-dlp
• Sharp
• FFmpeg

• Vitest

Norish is licensed under AGPL-3.0.

This list is not limited to the below but the ones I know:

• Mealie
• Tandoor

Last but not least, a picture of our lovely dog Nora: