Как получить короткий домен в зоне JS.ORG для своего пет-проекта

Знакомая история: вы написали классную библиотеку на JavaScript, выложили её на GitHub Pages, но ссылка вида имя-пользователя.github.io/название-репозитория выглядит громоздко. Хочется чего-то лаконичного, что сразу говорит о сути проекта. Покупать отдельный домен ради небольшой утилиты на NPM часто душит жаба, да и возиться с продлением лень.

Тут на помощь приходит проект JS.ORG. Ребята с 2015 года поддерживают инициативу по раздаче бесплатных поддоменов для JS-сообщества. Это не просто «еще один бесплатный хостинг», а способ сделать ваш проект частью глобальной экосистемы JavaScript.

Что это такое и зачем оно нужно

По сути, JS.ORG — это огромный заголовочный файл с настройками DNS, который живет в публичном репозитории на GitHub. Если вы занимаетесь разработкой инструментов, библиотек или фреймворков на JavaScript, вы можете прийти к ним и попросить адрес вида your-project.js.org.

Это бесплатно. Совсем. Проект живет за счет пожертвований и поддержки Cloudflare, которые помогают с DNS-инфраструктурой.

Основная ценность тут в узнаваемости. Домен js.org в адресе сразу намекает, что внутри лежит что-то полезное для фронтенд-разработчика или Node.js мастера.

Как это работает на практике

Процесс получения домена максимально «гиковский» — через Pull Request. Никаких форм регистрации или подтверждения почты. Весь флоу выглядит так:

Вы запускаете свой сайт на GitHub Pages (или любом другом хостинге, который умеет в CNAME).
Выбираете свободное имя. Обычно это либо ваш никнейм, либо название репозитория.
Добавляете файл CNAME в корень своего проекта.
Делаете форк репозитория js-org/js.org, вносите правку в файл cnames_active.js и создаете PR.

Если ваш проект соответствует правилам, модераторы одобрят правку, и через 24 часа домен заработает.

Кому домен не дадут

У ребят довольно жесткая политика фильтрации контента. Это сделано, чтобы зона не превратилась в помойку из дорвеев или личных блогов.

Домен не одобрят, если ваш сайт:

Это личное портфолио или резюме.
Просто страница-заглушка без контента.
Никак не связан с JavaScript.
Автоматически редиректит пользователя на другой ресурс.

Они ищут именно «существенный контент», полезный для сообщества. Если у вас есть пакет на NPM или инструмент для сборки — шансы почти 100%.

Технический нюанс с GitHub Actions

Если вы деплоите проект через GitHub Actions, обычный файл CNAME может не сработать. В этом случае нужно зайти в настройки репозитория (Settings -> Pages) и прописать нужный поддомен в поле Custom Domain прямо там. Только после этого делайте PR в основной репозиторий js.org.

Почему это круто

Я часто вижу, как хорошие тулзы теряются в дебрях github.io. Короткий адрес проще запомнить, он лучше смотрится в документации и в профиле на NPM.

Интересно, что проект существует уже почти 10 лет и за это время через него прошли тысячи доменов. Это отличный пример того, как сообщество само организует инфраструктуру без участия корпораций.

Конечно, есть риск, что завтра Cloudflare прикроет лавочку или у владельцев домена закончатся деньги на продление основной зоны, но пока проект выглядит очень стабильно. Если ваш опенсорс-проект подрос и ему пора обзавестись «взрослым» лицом — это самый простой и быстрый путь.

С чего начать? Просто загляните в файл cnames_active.js в их репозитории. Посмотрите, какие имена уже заняты, и оцените масштаб — там тысячи записей. Это вдохновляет.