• English
  • JSON Translate Deployment

    System Requirements

    • Node.js 20.9 or later
    • Supports macOS, Windows (including WSL), and Linux

    Local Deployment

    Ensure you have Node.js installed.

    # Install dependencies
    yarn
    
    # Local Development
    yarn dev
    
    # Build and Start
    yarn build && npx serve@latest out
    
    # Deploy for a Single Language
    yarn build:lang en
    yarn build:lang zh
    yarn build:lang zh-hant

    Open http://localhost:3000 in your browser to see the result.

    You can start editing the page by modifying src/app/[locale]/page.tsx. The page will auto-update as you edit the file.

    Vercel Deployment

    Click the button below to deploy JSON Translate to Vercel with one click:

    Vercel

    With Vercel, you can easily host your project, and it will automatically handle build and deployment — perfect for users who don't need complex server configuration.

    Cloudflare Pages Deployment

    Click the button or link below to fork this project, then follow the steps to deploy it on Cloudflare Pages:

    👉 Fork this project

    Deployment steps:

    1. Log in to Cloudflare Pages
    2. Click "Create a project"
    3. Connect the GitHub repository you just forked
    4. Configure the build and deployment settings:
      • Build command: npm run build
      • Build output directory: out
      • Environment variable: Add NODE_VERSION with the value 22.14.0
    5. Click the deploy button to start building!

    🎉 Once completed, you can access your own JSON Translation Tool!

    Docker Deployment

    If you prefer to run the application in a containerized environment, you can use the following methods to run JSON Translate via Docker:

    # Pull and run from ghcr.io
    docker run -d -p 3000:3000 --name json-translate ghcr.io/rockbenben/json-translate:latest
    
    # Or pull and run from Docker Hub
    docker run -d -p 3000:3000 --name json-translate rockben/json-translate:latest

    Once running, you can access it at http://localhost:3000.

    You can also deploy using a docker-compose.yml file:

    services:
      json-translate:
        image: ghcr.io/rockbenben/json-translate:latest
        container_name: json-translate
        ports:
          - '3000:3000'
        restart: unless-stopped

    Run the command docker-compose up -d to start the service.