Update: Buckets have gotten a major update. CLI examples below have been changed. To get the latest, check out the new Buckets documentation.
Textile is at EthDenver with a few new, shiny products for you to play with. The first one we'd like to share is a project called Buckets.
Dynamic Buckets pinned IPFS
If you are working with a team this year at EthDen, one of the easiest ways for you to pin and manage folders of assets, entire websites, or data on IPFS is by using Textile's new Buckets API and Dashboard.
- Buckets are dynamic folders synced over IPFS using the open data protocol, Threads.
- All data in a Bucket is pinned as fully functional DAGs on remote IPFS nodes.
- Any Bucket you create can be updated and modified by multiple owners (teams).
- Each Bucket has a static URL to share and explore the data.
- Each Bucket has a static URL for web rendering. Meaning you can publish fully functional websites and web-apps on a free domain.
- Buckets are free for EthDen hackers.
Getting Started with Buckets
Download the Textile CLI, create an account, team, project, and bucket.
Install the Textile CLI
- Head over to the Textile release page and grab the build for your laptop.
- Unzip or Untar the download file. Move the
textilebinary to your path (or use the
installscript to do it for you.
Create an account.
We use an email-based, passwordless login and account create. Just enter your email and await the verification email which will contain a confirmation link. Click the link and you are good to go.
The default account is your personal account on Textile. You should create a team so you can start inviting your co-hackers.
textile whoamito check which context you are in.
textile team add uniqueteamnamehereto create your new team.
textile switchand select your new team.
textile team inviteand you'll be prompted for an email for your team member.
Next, you'll want to create a project to manage with you team. Projects are scoped to a directory and will create a small hidden config file right in the folder you initialize the project in. This allows you to move around projects by change changing directories. Create a project,
mkdir -p somedirtousecreate a directory for a project, or CD into an existing repo.
textile project init someprojectnameproject names are unique, so pick a good one.
Now, you can start creating Buckets in your project. Your team will be able to see and pull them immediately.
mkdir -p testbucketto create a folder in your project for your first bucket.
echo "Hello Ethden." > testbucket/index.htmladd a file to your folder to push to a bucket.
textile bucket push testbucket/* someuniquenamebucket names are unique, so pick a good one.
- Visit your bucket dashboard at
https://cloud.textile.io/dashboard/<projectname>/<bucketname>. The Bucket URL is static, meaning you and your team can push updates and quickly view the live content.
This Bucket is special, because it contains an
index.html, I can also render it as a real website. To visit the live URL for site rendering, just go to the URL,
Win some Bounties!
There are a bunch of Bounties this year and some you are able to win simply by using Buckets to launch parts of your hack on IPFS! Check them out here, https://alchemy-xdai.daostack.io/dao/0x993c67b8830dac1bfda09e8be0dce8553cf84271/scheme/0xcb99e740cbbe2c293923c4032ea7b5beb5dae9260d9375a247cbd1c83c09b4aa
Here is a Bounty you can win just by using Buckets: https://alchemy-xdai.daostack.io/dao/0x993c67b8830dac1bfda09e8be0dce8553cf84271/proposal/0xf12dd3a509543a9212e96093f295ffeb918f05bfa6e1906873718070645306f5
If you want to learn more ways to use Textile this weekend (dynamic databases in your app, hosted IPFS, and more), take a look at our Bounty guide here, https://blog.textile.io/ethden-2020-textile-bounty-resources/