</>PackageGraphPackageGraph

tildify

npmv3.0.0

Convert an absolute path to a tilde path: `/Users/sindresorhus/dev` → `~/dev`

Not recommended for new projects

No — tildify should not be adopted for new projects. Last published 1854 days ago.

  • AAdoption: grade A, Excellent.

    5.1M downloads per week and 1 known dependents.

  • FMaintenance: grade F, Failing.

    Last published 1854 days ago.

  • AWeight: grade A, Excellent.

    Zero runtime dependencies, about 2.8 KB installed.

  • BSupply chain: grade B, Good.

    This package has a single maintainer (bus factor of 1).

  • ALicense: grade A, Excellent.

    MIT — permissive, with no copyleft found in the dependency tree.

Grades are computed deterministically from registry metadata collected by PackageGraph — downloads, dependents, publish dates, the resolved dependency tree, maintainer count, and declared licenses. No third-party scores are used.

Install cost

What you actually take on by adding tildify to a project.

0
Direct dependencies

Runtime packages this one declares itself.

0
Total installed

Distinct packages in the full runtime tree, deduplicated the way a package manager would.

2.8 KB
Install size

Unpacked size of this package plus its entire runtime tree.

—
Tree depth

Longest resolved dependency chain below this package.

Compatibility

Node.js
node ^12.20.0 || ^14.13.1 || >=16.0.0
Module format
ESM only
TypeScript
No bundled types
Install scripts
None

Quick start

A usage example from the tildify README.

jsFull README ↗
import tildify from 'tildify';

tildify('/Users/sindresorhus/dev');
//=> '~/dev'

tildify vs the alternatives

Packages solving a similar problem in the npm ecosystem, compared on the signals that drive an adoption decision.

PackageWeekly downloadsDependentsLicenseLast release
tildifythis page5.1M1MIT5 years ago
userhome01MIT14 days ago
env-paths02MIT13 days ago
slash014MIT13 days ago
make-dir02MIT13 days ago
find-up04MIT14 days ago

Dependencies

Declared by tildify v3.0.0. Runtime dependencies are installed with the package; dev dependencies are not.

Dev (3)

ava ^3.15.0tsd ^0.17.0xo ^0.44.0

Used by

Popular packages that depend on tildify.

knexnpm

A batteries-included SQL query & schema builder for PostgresSQL, MySQL, CockroachDB, MSSQL and SQLite3

↓ 0/wk◈ 1 dependents⚖ MITTS

Relationship graph

Dependencies (left) and dependents (right) of tildify.

knextildify
tildify dependencies dependents

Frequently installed together

commandernpm

the complete solution for node.js command-line programs

↓ 503.4M/wk◈ 11 dependents⚖ MITTS
escaladenpm

A tiny (183B to 210B) and fast utility to ascend parent directories

↓ 197.4M/wk◈ 3 dependents⚖ MITTS
lodashnpm

Lodash modular utilities.

↓ 175.4M/wk◈ 20 dependents⚖ MIT
eslintnpm

An AST-based pattern checker for JavaScript.

↓ 160.1M/wk◈ 277 dependents⚖ MITTS
prettiernpm

Prettier is an opinionated code formatter

↓ 133.3M/wk◈ 157 dependents⚖ MITTS
chainpm

BDD/TDD assertion library for node.js and the browser. Test framework agnostic.

↓ 112.5M/wk◈ 56 dependents⚖ MIT
colorettenpm

🌈Easily set your terminal text color & styles.

↓ 77.8M/wk◈ 2 dependents⚖ MITTS
pg-connection-stringnpm

Functions for dealing with a PostgreSQL connection string

↓ 52.6M/wk◈ 2 dependents⚖ MITTS
ts-nodenpm

TypeScript execution environment and REPL for node.js, with source map support

↓ 49.3M/wk◈ 38 dependents⚖ MITTS
pgnpm

PostgreSQL client - pure javascript & libpq with the same API

↓ 48.6M/wk◈ 5 dependents⚖ MIT
mysql2npm

fast mysql driver. Implements core protocol, prepared statements, ssl and compression in native JS

↓ 15.5M/wk◈ 3 dependents⚖ MITTS
tarnnpm

Simple and robust resource pool for node.js

↓ 7.7M/wk◈ 2 dependents⚖ MITTS

Release history

No releases in the last two years, typically about 191 days apart.

Recent versions of tildify
VersionPublishedSizeLicense
3.0.0latest5 years ago2.8 KBMIT
2.0.07 years ago2.9 KBMIT
1.2.010 years ago—MIT
1.1.211 years ago—MIT
1.1.111 years ago—MIT
1.1.011 years ago—MIT
1.0.012 years ago—MIT
0.2.012 years ago—MIT
0.1.012 years ago—MIT

Overview

tildify is an npm package that convert an absolute path to a tilde path: `/Users/sindresorhus/dev` → `~/dev`. It is very popular, with about 5.1M downloads per week and 1 known dependents in the graph. The latest version is 3.0.0, released under the MIT license.

Who should use it

Teams working in the npm ecosystem who need convert an absolute path to a tilde path: `/Users/sindresorhus/dev` → `~/dev` and value a battle-tested, widely-adopted solution.

When not to use it

Consider an alternative if you need to have first-class TypeScript types out of the box, or if a more actively-maintained option better fits your npm stack.

Pros

  • Large, well-established user base (5.1M weekly downloads).
  • Clear open-source license (MIT).
  • Lean dependency tree (3 direct dependencies).

Cons

  • No bundled TypeScript types (may require a separate @types package).

Auto-generated from collected registry metadata. No external claims are inferred.

Maintainers

sindresorhus

Keywords

collapseconvertdirectoryexpandhomehomedirpathtildetildifyunexpanduser

Funding

Frequently asked questions

Should I use tildify?

No — tildify should not be adopted for new projects. Last published 1854 days ago.

How do I install tildify?

Run `npm install tildify` to add tildify to your npm project.

What license is tildify released under?

tildify is distributed under the MIT license.

How popular is tildify?

tildify has approximately 5,117,717 downloads per week and 1 known dependent packages.

Is tildify still maintained?

The most recent release of tildify (v3.0.0) was published 5 years ago.

Does tildify run install scripts?

No. tildify does not define preinstall, install, or postinstall scripts, so installing it does not execute publisher-supplied code.