// Featured Article

Illustration of a hand holding an IC transit card over a Japanese ticket gate, with stylized clouds and trees in the background.
The Story of Suica, Japan’s First IC Transit Card

The humble Suica card was developed in the 90’s and has kept Japan moving for almost three decades. Here’s the story of how it came to be.

// TokyoDev Basics

TokyoDev
Survey 2025

TokyoDev conducts annual surveys on developer compensation, demographics, remote work opportunities, job-searching, technologies and more.

🍡

// Collections

// Living in Japan (Show all)

Illustration of a four-member band performing, with three guitarists and a drummer playing together on stage.
How I Joined a Band in Japan with Absolutely No Experience

At 40, a longtime Japan resident decided to join a band. Here’s what he learned about finding bandmates, rehearsing, and playing live shows in Japan.

Illustration of a Muslim couple shopping at a Japanese self-checkout convenience store. The woman wears a pink hijab and carries a basket containing halal-labelled groceries, while the man wears a black kufi and taps the self-checkout screen. Above them, a collage of software engineering imagery—including code, gears, a web page, a development team, and the Japanese word "セルフレジ" (self-checkout)—connects their experience of working in tech with everyday life in Japan.
Being a Muslim Software Engineer in Japan

Learn what daily life is like for a Muslim software engineer in Japan, including halal food, Friday prayers, Ramadan, and workplace accommodations.

Illustrated cover showing a red-haired woman in a Japanese kitchen carrying a steaming pot with oversized oven mitts while looking out at a countryside neighborhood. Surrounding panels depict gift-giving and hospitality: wrapped presents, omiyage snacks, a basket of fresh vegetables, tea, folded cloths, flowers, and a handwritten note, conveying the warmth and generosity of life in the Japanese countryside.
Gift-Giving in Japan: What Life in the Japanese Countryside Taught Me

Feeling overwhelmed by Japan’s intensive gift-giving culture? Here are my personal experiences, suggestions, and survival strategies.

A person at a desk with the help mark on it accommodates a hearing impaired person by writing instead of speaking.
Living with a disability in Japan

This article is informed primarily by my experiences as a deaf American living in Japan for the last 16 years. It covers the challenges someone with a disability will face and the accommodations available.

Joining Toastmasters in Japan to Make Friends

What is Toastmasters like in Japan? A personal look at joining a Fukuoka club, improving public speaking, and making friends across cultures and generations.

Buying and renovating a 40-year-old Japanese house

A firsthand look at buying and renovating a cheap used home in Japan, from securing a mortgage to handling unexpected repairs and renovation costs.

My Deaf Experience in Japan

Living with deafness in Japan for nearly 20 years — navigating work, communication, accessibility, and daily life as a deaf resident.

Investing in Japan When You Might Leave Next Year

Avoiding investing in Japan because it feels overwhelming? It’s easier than you think—learn how to get started, even if you don’t plan to stay long.

// Developer Experiences (Show all)

Ann on  playground equipment shaped like a giant squid.
Eight Years in Japan: Planting Early Seeds for Long-Term Success

Ann Kilzer relates her crash-landing in Tokyo, the work and lifestyle changes she’s observed, and why it’s so important to take time to understand Japan.

Richard standing next to a KOMOJU by Degica sign.
Thirteen Years in Japan: Richard Ramsden On Finding Your Company

Richard Ramsden, CTO at Degica, talks about why which company you work for in Japan makes all the difference.

Anditto presenting at an event.
Fifteen Years In Japan: Anditto Heristyo’s Balancing Act

Deputy Manager Anditto Heristyo explains the importance of finding the right cultural balance at work, and why you should always choose the high road.

Matt sitting.
Twenty Years in Japan: From Mobile Developer to Engineering Manager

Engineering Manager Matthew Gillingham talks about the engineer shortage in Japan, the pros and cons of not being Japanese, and his top two tips for other developers.

A Woman using a mouse while looking at one of two monitors.
So You Want to Be a Game Dev in Japan

Five developers share the good, the bad, and the ugly of being a game developer in Japan, and their top tips for entering the industry.

How to Avoid (Or Survive) a “Black Company” In Japan

How to spot and avoid black companies in Japan, recognize common red flags and labour law violations, and protect yourself if you end up working for one.

Anonymous
Beyond Japan’s Big Cities: Life as a Software Engineer in Kumamoto

Living in Kumamoto, Alamsyah shares what remote tech work in regional Japan is really like, including the trade-offs it comes with.

// Working Conditions (Show all)

A three panel image. The first has a man with a backpack looking at a hat. The second has a mother with a baby. The third has a masked man lying in bed.
Paid Leave and Vacations in Japan

This article will help you understand what holidays you’re entitled to receive in Japan, along with what you can expect to be able to actually take.

A man in a suit sitting in an empty row of chairs
You’re Too Old For That: Age Discrimination in Japan Tech

An overview of the legal and cultural context for age discrimination in Japan's tech industry.

The PIP Trap: Why Performance Improvement Plans Don’t Mean What You Think in Japan

A PIP in Japan rarely ends your employment—but believing it will often does. Here’s what to do if you receive a PIP.

Overtime in Japan Explained: Laws, Pay Rates, and Fixed Overtime (Minashi Zangyou)

A deep dive on what’s legal, why companies include fixed overtime in contracts, and how much overtime international developers in Japan really work.

// Job Hunting (Show all)

Three people in a group interview.
Getting a Job in Japan as a New Grad

Learn how new grads are hired in Japan and how to improve your chances of getting a tech job in Japan.

A fox in a suit with icons over their head
Recruitment Agencies in Japan: How To Get Them To Work For You

This article aims helps you understand the structure of recruiting in Japan and assist you in your job search, with a focus on those looking to work as an engineer in Japan.

A map of the journey to being a software developer in Japan
How to Get a Software Developer Job in Japan

A guide to understanding your chances of getting a job as a programmer in Japan are, and what the first steps you can take are.

// Japanese Society (Show all)

Anime-style VTuber wearing pink cat-ear headphones and a T-shirt with a sleeping cat design, smiling and making peace signs in front of a dual-monitor streaming setup. One monitor shows digital art and a chat window, while the other displays editing software. A microphone, white-and-pink gaming chair, and pink striped background complete the cozy streaming workspace
VTubing: How a Japanese Phenomenon Is Going Worldwide

While Japanese agencies continue to dominate the industry, non-Japanese VTubers are forging their own unique paths to success.

Many laptops but only a couple occupied. A person with a suitcase walks towards them.
Japan Needs International Developers

How Japan's labor shortage equals career opportunities for certain international developers.

A skeletal DM holds a glistening pair of d20s for an eclectic party
The rise and fall of D&D in Japan

In 1985, D&D had a massively successful release in Japan. However, its popularity quickly waned. This article chronicles the rise and fall of D&D in Japan.

// Visas (Show all)

A person jumping through the air, reaching for a passport.
How I Got a Digital Nomad Visa for Japan

Curious about living in Japan? Learn from Christian, one of the first digital nomad visa holders, as he shares his experience and tips for obtaining the visa.

Hands holding a visa with a rising sun in the background
Visas for Software Engineers in Japan

The complete guide to visas that permit you to work as a full time software developer in Japan.

Is Japanese Citizenship Right for You?

Get insight into the ‘why’ and ‘how’ of naturalizing in Japan, via the personal experiences of two IT professionals who successfully became citizens.

Extending My Japanese Visa as a Freelancer

My personal experience extending my work visa in Japan as a freelancer—with dependents, a new sponsoring company, a recent move, and other fun factors. Spoiler alert: it was easier than I thought it would be!

// Relocating to Japan (Show all)

Three students in thought. One student has a backpack on her chair and is working at a computer while being instructed by a professor.
Attending Vocational School to Get a Developer Job in Japan

International students at Japanese vocational schools are rising fast. Two recent graduates share the costs, benefits, challenges, and how they landed developer jobs.

A laptop, map, and books about Japan.
A Developer’s Crash Course in Coming to Japan

We’ve gathered statistics, other developers’ experiences, and advice from industry professionals to help you decide if you want to move to Japan, and what your best visa and job options are.

An apartment building where you can see into six units. A woman is reading a newspaper in one. In another, a man is working on a computer. A raven is in the foreground cawing.
There’s No Place Like Home: Finding an Apartment in Japan

This guide to finding an apartment in Japan helps you understand the costs involved, and how to go about looking for a place to call your own.

Pets awaiting transport to Japan
Bringing Your Pets to Japan

Thinking about moving to Japan with your pet? Read this article now, as you might need to prepare almost a year in advance.

Guesstimating Your Lifestyle in Japan

How much money do you need to make to live comfortably in Japan? This article helps you build a rough estimate

The Fundamental Information Technology Engineer Examination: My Experience

Learn how the Fundamental Information Technology Engineer Examination opens doors to Japan without a degree or extensive experience. Thomas shares his journey.

// Family Life

A family at the arrivals lobby
Bringing Your Family to Japan

How developers can bring their spouse and children to Japan.

Two children running towards two different schools: an international and Japanese one
Japanese vs International Schools: Which Will Work for Your Children?

An overview of Japanese vs. international schools, and what you can expect from the public school system.

Exacerbated parents try to work as children play
Childcare Options in Japan

Navigating childcare in Japan? Discover a variety of options tailored to your location, your child's age, and the season. Start here for a comprehensive guide to common childcare services.

A father changing a newborn.
Paternity Leave in Japan

An overview of Japan's paternity leave system, including the options and benefits available.

What Inclusive Education Really Looks Like in Japan

Drawing on my experience raising a neurodivergent child here, this article explores the support available in Japanese schools and what families can expect when navigating the system.

Raising Bilingual Children in Japan (Without Breaking the Bank)

Research shows that speaking two languages at home doesn’t ensure your children will become bilingual. Here’s how I'm raising my children to comfortably speak both English and Japanese.

Reduced Hours and Remote Work Options for Employees with Young Children in Japan

A recent update to the Child Care and Family Care Leave Act expands the benefits available for employees with small children. But are there downsides?

Discount coupons for babysitters in Japan via a government subsidy

Save up to ¥4,400 per child on a babysitter with this government subsidy.

// Working in Japan (Show all)

Illustration of a person performing on stage while three judges watch from a table in the foreground. Behind the performer, a diverse audience applauds from theater seating framed by red curtains. The performer gestures animatedly, suggesting an improv or public speaking performance, while the judges take notes and review materials.
Yes, And: What an Improv Stage Can Teach You About Leading Cross-Cultural Teams in Tokyo

What does 20 years of improv comedy teach about leading product teams in Japan? Four practical habits for listening, collaboration, and resilience.

Illustration of people participating in a tech event
Tech Meetups in Tokyo

A guide to tech meetups in Tokyo, including where to find them and the differences between Japanese and English meetups.

Should Software Developers Take the JLPT?

If you’re a software developer in Japan, you may wonder if the JLPT is worth your time. Here’s my take on the exam, and who it’s really good for.

Tech Conferences in Japan

Discover the most popular developer conferences in Japan, with details on location, languages, ticket prices, attendance, and dates.

// Resumes and Interviewing (Show all)

A pair of hands over a resume, one of them holding a magnifying glass.
How to Pass the Resume Screening Stage in Japan

Nine recruiters go into detail on what causes them to accept or reject candidates’ resumes, and how to improve your chance of success.

Foxes in short sleeved shirts with black ties inspecting resumes on a conveyor belt.
How to Write Resumes for Jobs in Japan

A guide for how to format an English CV when applying to a company in Japan.

A Guide to Writing Japanese Resumes

How to write a Japanese shokumu keirekisho (職務経歴書) for developer jobs in Japan—when to use it, what to include, and how to impress recruiters.

What is a “casual meeting” in Japan?

The Japanese-style "casual meeting" is a terrific way to find out whether you're suited for a particular company and whether that company is a good fit for you.

// Japanese Language (Show all)

Two people stand side by side, their faces half-covered with a fox mask.
Become a Great Communicator in Japanese

What is “reading the air”? Why do Japanese people ignore me sometimes?

How Magic: The Gathering Took Me from N2 to Japanese Fluency

Passing the JLPT N2 is one thing, but actively managing projects in Japanese is another. This is how I used Magic: The Gathering to bridge the gap from academic study to professional confidence in Tokyo.

Working and Communicating with Japanese Engineers

Working on an international tech team comes with communication challenges that go beyond just language. Here’s some practical advice I’ve gathered in my ten years of working in Japan.

// Hiring Developers (Show all)

A person smiling while viewing a pamphlet with "Developer Wanted" on the cover.
Crafting Job Postings Developers Actually Want to Read

Practical tips for writing job postings that attract the developers you want to hire, based on reviewing 1,000+ postings and seeing what truly works.

A woman typing on a keyboard and glancing at one of three screens.
A Four-stage Approach for Hiring Women on your Engineering Team

Strategies for not only attracting more women as candidates, but also helping you to hire and retain them.

The Challenges Faced by Multinational Teams and Japanese Companies

Japanese businesses discuss the two main problems they have encountered hiring internationally, and their solutions.

If You Want To Hire Great Engineers, Let Engineers Do The Hiring

Discover how Eugene designed a hiring process that reviewed 1,500 applications to hire 15 engineers, focusing on technical skills and mission-driven passion.

// Business in Japan (Show all)

How to Create a Company in Japan
How to Create a Company in Japan

An overview of the gotchas when incorporating a company in Japan based on my personal experience of incorporating three of them.

Choosing Between a Company and a Sole Proprietorship in Japan

Considering starting a business in Japan? Learn when a sole proprietorship is enough, when a company makes sense, and the real tradeoffs in taxes, liability, and ownership.

Converting a Japanese Sole Proprietorship to a Company

How to transfer contracts and IP from an individual to a Japanese company.

Keeping your job board legal in Japan

In October 2022, new regulations were put into place that put legal requirements on job board operators.

Running a job board in Japan can land you in prison

Operating a job board in Japan can lead to legal issues if not properly licensed. This article explains the legal requirements and guidelines for running a job board without facing penalties.

// Technology in Japan (Show all)

Illustration of a hand holding an IC transit card over a Japanese ticket gate, with stylized clouds and trees in the background.
The Story of Suica, Japan’s First IC Transit Card

The humble Suica card was developed in the 90’s and has kept Japan moving for almost three decades. Here’s the story of how it came to be.

Japan flag and accessibility flag
Web Accessibility in Japan: What Developers Need to Know

An interview with Makoto Ueki, the founder of a web accessibility consultancy that services large Japanese clients, about web accessibility in Japan.

A Look Into NaviDial, Japan’s Legacy Phone Service

Here’s the story behind Japan’s most controversial phone service, and what you can personally do to avoid being overcharged.

A Horrifying User Experience

A moving company estimate site overwhelmed me with constant calls, creating a frustrating experience.

// Diversity & Identity (Show all)

Illustration of a woman in a dress surrounded by cherry blossoms, mirrors, and scenes reflecting different aspects of her life in Japan.
Being Trans in Japan: One Trans Woman's Experience

A trans woman shares her experience moving to Japan, from finding gender-affirming healthcare and work to building friendships and navigating daily life.

Anonymous
drawing of a female software developer working at a desk
Working as a Female Software Developer in Japan

Telling the experiences of women who work as software developers in Japan, covering the positives and negatives of working here.

Working as a Filipino Software Developer in Japan

This article aims to provide insight and help for Filipinos software developers looking for a job in Japan.

From Mongolia to Japan as a Software Engineer

Azjargal shares her journey of finding a job as a software engineer in Japan, and introduces some Mongolian communities in Japan.

// Startups (Show all)

People holding a rocket ship over their head.
How to Grow Your Startup Through Community

Investing 1000+ hours and ¥8 million in developer communities hasn’t brought much in direct returns but has still been the key to my startups' success.

Paul working on a computer connected by a network of people
Personal Blog to Profitable Business: the Story of TokyoDev

This is the story of how the site has evolved from its humble origins as my personal blog to a flourishing job board and community that serves tens of thousands of visitors per month.

Why I sold Doorkeeper

After working on it for more than ten years, I sold Doorkeeper, an event management platform I bootstrapped.

Calculating your growth ceiling

Learn to calculate your business’s growth ceiling using key metrics like churn rate and customer acquisition.

// Salaries (Show all)

A person using a laptop with displaying a piggy bank and Japanese yen
Software Developer Salaries in Japan

Compiles various sources for software developer salary data to help you judge the market.

A Guide to Salary Negotiations in Japan’s Tech Industry

Wading through the cultural differences to maximize your salary as an expat in Japan's tech industry.

Will a company in Japan find out your previous salary?

Companies in Japan can roughly figure out what you made at your previous job, so you might be caught if you exaggerate your compensation.

// Software Development (Show all)

A scale with a laptop on one side, a hand placing blocks of code on the other.
All code is technical debt

As adding more code to a product will slow down development, we should view all code as technical debt.

Renaming an Active Record has_one_attached Attachment: A Step-by-Step Guide

A step by step guide on how I used a migration to fix the typo in the has_one_attached association.

From Paperclip to Active Storage: An incremental, zero-downtime approach

This article covers a zero-downtime approach for migrating from Paperclip to Active Storage in Rails, focusing on best practices for smooth transitions.

Generating social images with static site generators

Learn how to generate social images for static sites using tools like HCTI API and Middleman, ensuring a smooth process for creating shareable visuals at build time.

Safari bug with ruby tag

Safari 12.1.1 has a bug causing crashes when clicking ruby tags, particularly with Japanese kanji readings.

// Mental Health

Mental Health in the Japanese Tech Industry

This article describes the mental health challenges a foreigner working in Japan may experience, and the available resources.

Claiming Sickness Allowance for Mental Health Leave

Mental health leave in Japan is nothing to be ashamed of. Learn how the country's medical leave system can support your recovery.

Dealing with Pathological Anxiety in Japan

An account of my experiences dealing with my mental health while navigating the Japanese medical system.

// Announcements (Show all)

Organizing a tech meetup in Japan? TokyoDev will sponsor you.

TokyoDev reimburses sponsored events up to ¥1,000 per attendee—typically enough to cover pizza and drinks.

Scam applicants are an increasing problem in Japan

Paul shares red flags to look for, tips for catching scammers, and how TokyoDev is handling these fake job applicants.

TokyoDev’s 2025 Recap: A Record Year

Reflections on 2025's milestones for TokyoDev and what they mean for us going forward.

The 2025 TokyoDev Developer Survey Results Are Live!

TokyoDev's 2025 Developer Survey had 989 respondents. Explore insights on pay, remote work, the gender gap, job satisfaction, and more!

Identifying and Fixing a Resume Visibility Mistake

Resumes from 460 individuals submitted to TokyoDev were accidentally exposed on Bing. We explain who was affected, why it happened, and our response.

Announcing the 2025 TokyoDev Developers Survey

Our annual developer survey is now live! If you’re a software developer living in Japan, please help us by taking it.

// Freelancing

Working as a Freelance Tech Professional in Japan

Learn how a freelance Data and ML Engineer built a successful career in Japan, including setup, finding clients, what clients expect, and the financial side.

// Event Reports (Show all)

RubyKaigi 2025 Recap

Recapping RubyKaigi 2025, three days in Matsuyama packed full of learnings, meetings, and mikan.

RubyKaigi 2023 Recap

Recapping my first RubyKaigi - an unforgettable community experience.

Rails Girls Nagasaki 1st Recap

Recapping the first Rails Girls event held in Nagasaki

RubyKaigi 2024 reflections

A summary of TokyoDev's activities at the world's largest Ruby conference.

What if We Had a Party, but the Entertainment was a Conference: Tokyu RubyKaigi 14 Recap

Tokyu RubyKaigi was one of the more unique conferences I've been to — and it was a lot of fun.

Pair Programming Event a Success

Tokyo Rubyist Meetup’s first pair programming event brought Japanese and international developers together through hands-on collaboration—here’s how it unfolded.

// Company Profiles

A Win-Win: Multinational Development Teams at Givery

What is it like to work as an engineer in a multinational team at a Japanese company? Givery offers a case study.

How Cybozu Built an International Engineering Team

How one of Japan's first B2B software companies has built an English-speaking team from scratch.

Service Introduction: Forkwell

Forkwell is a platform for engineers to showcase their skills and network. It allows users to endorse each other's abilities, helping engineers find jobs and companies find talent more efficiently.

// Misc

LinkedIn’s Broken Automation Took Down My Company’s Page Without Warning

TokyoDev's LinkedIn page was taken down due to broken automation on their side. Here's what happened.

Unbricking my MacBook took an email to Tim Cook

After my lost MacBook was returned to me with an Activation Lock on it, Apple refused to unlock it. Only after emailing Tim Cook could I get it unlocked.

Not setting up Find My bricked my MacBook

How I had paid ¥77,619 (500 USD) to have a bricked MacBook returned to me.

// Karuizawa

Things to Do with Kids in Karuizawa

A parent’s guide to the best things to do with kids in Karuizawa, from playgrounds and easy hikes to ice skating, pools, museums, and nearby day trips.

Top Coworking Spaces in Karuizawa

Personal impressions of coworking spaces and other places to work in the town of Karuizawa, where I currently live.