Jan 17, 2023

The CLI Beta is Live, with IPFS Pinning & IPNS.

The CLI Beta is Live, with IPFS Pinning & IPNS.

This is not a drill, it’s Fleek.xyz first beta release. We are stoked to start the first chapter of Fleek’s new platform with the test-phase of our new CLI and its two services: IPFS pinning and IPNS mapping. Both services are live and ready to be battle-tested.

Tested by whom, you ask? Well everyone’s welcome! If you’ve signed up for our newsletter already, you probably got the heads-up already, else… Our docs are live and ready for testers to follow, and if you find any bugs or have feedback to share: let us know here, it’ll be greatly appreciated!

We’re kicking off with Pinning and IPNS, and expect us to follow up on our next release with Sites Deployment. In this beta, we want to hear from developers testing our CLI, as we prepare to build these services in Fleek’s UI, API, and SDK.

Join us as we go over what’s included in this first release. ⚡️

Fleek’s Command-line Interface

Fleek’s Command-line Interface

Today we present the first of Fleek’s building blocks and interface: the Fleek CLI. Together with the Fleek SDK, Fleek API, and Fleek app UI, this command-line-interface will be one of the options for developers to use and integrate Fleek’s services.

npm install -g @fleek-platform/cli
$ fleek login
🔗 Opening browser on https://app.fleek.xyz/login.html?verificationSession=...
🧑‍💻 Please login to continue
✅ Successfully logged in.

The command line interface provides direct access to Fleek’s services suite, starting with IPFS Pinning and IPNS hash mapping in this beta. Via simple commands, developers can easily create an account and authenticate to Fleek, push and pin files to IPFS, get their hashes, as well as create and manage IPNS records.

The CLI will grow as more services are added to the platform (Sites Deployments coming next). You can find the CLI’s NPM here, and we welcome everybody to share any thoughts and feedback here!

IPFS Pinning on Fleek

IPFS Pinning on Fleek

Fleek’s bread and butter, web3 storage management and IPFS file pinning. IPFS will be the first service in the storage category, which will be followed by other protocol’s services in the future, such as Filecoin and Arweave, built by us and the community. Given each will be built as independent services, anyone can contribute their own to Fleek.

 > fleek ipfs add hello.txt
 > ⚡ IPFS Hash: Qmanou5uhcGhyW7noyB7LNFJBZkKcuUZnmpHeQSaidJ367

All it takes to pin a file with the CLI is a three-word command, and a file. Fleek will handle the upload to an IPFS node, and will report back the file’s hash as proof of the success of the operation.

You can see the file in any public IPFS gateway, or browser that resolves IPFS hashes, and soon we will add a user’s usage stats and the ability to fetch all pinned files. In the near future, Fleek will add custom domain gateway options for users who want custom gateway endpoints - as well as a default option.

IPNS Record Management

IPNS Record Management with Fleek

The second service in this beta is one of IPFS’ other features, IPNS (the InterPlanetary Name System). IPFS hashes are immutable, which means they are static. If the file changes, the IPFS hash changes as well.

 > fleek ipns create
 > ✅ Success! IPNS record created.
 > 📓 k51qzi5uqu5didozh8jmvbnowwj2d545yacagcply19yvjz8rhn0i1hrbw2thy

IPNS records allow developers to create a static hash that maps to a dynamic record. This way, for example, you could map an IPNS hash to a website’s .html IPFS hash. Each time you make a deployment and the content changes (hence changing the IPFS hash of the file), your main address remains the same for the user (IPNS), but you update the IPFS hash resolved by the IPNS name via the CLI.

How do you do it in the CLI? With the command above. In this beta, you can create and manage new IPNS records, publish auto generated IPNS names for any hash, list all your records, and set IPNS names to resolve to any hash. More in the documentation.

Now that the CLI is out on beta, expect updates to its features and services on a regular basis. The team’s working in parallel in more services and in fact, as you read this, we are cooking up Sites Deployments and Custom Domains 😉.

We can’t be more excited to start getting Fleek’s new tools into the hands of the community, so thanks from the team for helping us test! Come say hi on our Discord, and bring any feature ideas over.

What’s next on the table? We’ll be working on improvements to storage, and how users can resolve/access their files, as well as growing the App UI for manual file upload, and Sites Deployments via CLI.

For more resources visit our LinkTree.