![\"Follow](\"follow-df-json.png\")
\nAfter you clone the project, create a local.xcconfig file inside the Planet subdirectory, not at the root of the project.
cd Planet\ncode local.xcconfig\nThe local.xcconfig file should be in the same directory as Planet.xcconfig, not at the root level of the project.
Fill it with the following, and replace DEVELOPMENT_TEAM with your own team ID.
CODE_SIGN_STYLE = Automatic\nDEVELOPMENT_TEAM = 66KP7KX9MX\nPLANET_APP_ICON_NAME = AppIcon-Debug\n\nWALLETCONNECTV2_PROJECT_ID = ""\nETHERSCAN_API_TOKEN = ""\n\nASSETCATALOG_COMPILER_GENERATE_ASSET_SYMBOLS = NO\nASSETCATALOG_COMPILER_GENERATE_ASSET_SYMBOL_FRAMEWORKS = ""\nASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOL_EXTENSIONS = NO\nIf you want to touch the Wallet-related parts, please supply your own WalletConnect project ID and Etherscan API token.
\n", "created" : 787851938.084845, "externalLink" : "", "hasAudio" : false, "hasVideo" : false, "id" : "63B38F91-2690-4D2A-8AFB-54084794E2D4", "link" : "/build/", "slug" : "build", "tags" : { }, "title" : "How to Build" }, { "articleType" : 0, "attachments" : [ "follow-df-json.png" ], "cids" : { "follow-df-json.png" : "QmXrv4AuZAdZxmhqLcfEa6zjN5dG9o3159Ht2uANYUMRZ1" }, "content" : "Planet is more than just a website builder. You can also use it to follow updates from various content sources, including:\n\n- Other Planet sites published via **IPNS** addresses, or via **ENS** (.eth) / **SNS** (.sol) addresses\n- **RSS**, **Atom**, or **JSON Feeds** on HTTPS addresses\n\nTo follow a source, click the + button in the main interface and select **Follow Planet**. Then enter the address to start receiving updates.\n\n\nPlanet is more than just a website builder. You can also use it to follow updates from various content sources, including:
\nTo follow a source, click the + button in the main interface and select Follow Planet. Then enter the address to start receiving updates.
\n\n![\"Planet](\"planet-api-server.png\")
\n![\"Planet](\"web-client-elementary.webp\")
\nPlanet provides a RESTful API server for automation and remote access. You can enable the API server in the Settings menu.
\n\nBy default, the API server runs on port 8086. Once enabled, it can be accessed at:
\n\nOr via your local network IP address.
\nHere is the full list of API endpoints:
\nhttps://github.com/Planetable/Planet/blob/main/Technotes/API.md
\nPlanet includes a built-in web client for remote access. Once the API server is running, you can access the web client at:
\n\n\n![\"ENS](\"ens-edit-records.png\")
\n\nThen click **Save**.\n\nIt will take 1–2 minutes for the change to take effect. After that, you can visit your site using these ENS gateways:\n\n- yourname.eth + `.limo`\n- yourname.eth + `.sucks`\n\nFor example, my ENS name is `planetable.eth`, and I can access my site using these addresses:\n\n- [planetable.eth.limo](https://planetable.eth.limo/)\n- [planetable.eth.sucks](https://planetable.eth.sucks/)",
"contentRendered" : "ENS (Ethereum Name Service) is a powerful naming system running on the Ethereum network. With Planet, you can set up and keep updating a blog on yourname.eth.
\nYou can register an ENS name at app.ens.domains.
\nAfter registering your ENS name, go to the Records page of your name and click Edit Records.
\nIn the Planet app, right-click on the site you want to link to your ENS and select Copy IPNS.
\nAppend ipns:// to the IPNS string (it starts with k51) you copied, and paste it into the Other ❯ Content Hash field like this:
\nThen click Save.
\nIt will take 1–2 minutes for the change to take effect. After that, you can visit your site using these ENS gateways:
\n.limo.sucksFor example, my ENS name is planetable.eth, and I can access my site using these addresses:
\n\t\t![\"template-plain\"](\"template-plain.png\") \n\t | \n\t\n\t\tPlain\n\t\t The default template. Minimal. Supports both light and dark modes. \n\t\tExample Site: planetable.eth \n\t | \n
\n\t\t![\"template-sepia\"](\"template-sepia.png\") \n\t | \n\t\n\t\tSepia\n\t\t Great for microblogging. \n\t\tExample Site: artificial.iweb.eth \n\t | \n
\n\t\t![\"template-8bit\"](\"template-8bit.png\") \n\t | \n\t\n\t\t8-bit\n\t\t Pixelated experimental design. 8-bit nostalgia. \n\t\tExample Site: gamedb.eth \n\t | \n
\n\t\t![\"template-grid\"](\"template-grid.png\") \n\t | \n\t\n\t\tGrid\n\t\t Grid design. Great for photos. Supports both light and dark modes. \n\t\tExample Site: yihanphotos.eth \n\t | \n
![\"template-browser\"](\"template-browser.png\")
",
"contentRendered" : "When building sites with Planet, you can switch between templates (or themes) for the same content. You can even build your own template with HTML.
\nPlanet includes several built-in templates; here is an overview of them.
\n| \n\t\t\n\t | \n\t\n\t\tPlain\n\t\t The default template. Minimal. Supports both light and dark modes. \n\t\tExample Site: planetable.eth \n\t | \n
| \n\t\t\n\t | \n\t\n\t\tSepia\n\t\t Great for microblogging. \n\t\tExample Site: artificial.iweb.eth \n\t | \n
| \n\t\t\n\t | \n\t\n\t\t8-bit\n\t\t Pixelated experimental design. 8-bit nostalgia. \n\t\tExample Site: gamedb.eth \n\t | \n
| \n\t\t\n\t | \n\t\n\t\tGrid\n\t\t Grid design. Great for photos. Supports both light and dark modes. \n\t\tExample Site: yihanphotos.eth \n\t | \n
Tool for managing templates. You can find Template Browser under the menu Tools.
\n\n",
"created" : 768425939.589855,
"externalLink" : "",
"hasAudio" : false,
"hasVideo" : false,
"heroImage" : "https://docs.planetable.eth.sucks/templates/template-browser.png",
"heroImageFilename" : "template-browser.png",
"heroImageHeight" : 1552,
"heroImageURL" : "https://docs.planetable.eth.sucks/templates/template-browser.png",
"heroImageWidth" : 2306,
"id" : "BE61BDB0-0E5F-4A4D-B48C-8A5338C0CABF",
"link" : "/templates/",
"slug" : "templates",
"tags" : {
},
"title" : "Templates"
},
{
"articleType" : 0,
"attachments" : [
"ipns-docs.ipfs.tech.png",
"ipns-planetable.eth.png",
"ipns-vitalik.eth.png",
"uniswap-cid.png",
"ipfs-open.webp"
],
"cids" : {
"ipfs-open.webp" : "QmSgVJtXbXx6UYjJNcDy7ViHTtKiE4e8UcfYSVKNePeP9u",
"ipns-docs.ipfs.tech.png" : "QmZafptesz8NiY1ReC1w5o1pCmGZAteyhRKtYrd4UYbwo3",
"ipns-planetable.eth.png" : "QmUvcejZAbBGPdWTNXUJJUWqidfpbVNJXS8xyfohJJD5o7",
"ipns-vitalik.eth.png" : "QmTRnw2uSFYm7fikYR2j8A1xjXxH3hqhMKyePpbXbn7ies",
"uniswap-cid.png" : "QmduyA7qYd9pFvyAC1D6Vbu1Y6RvqbnDdP5aBm7944Hzq3"
},
"content" : "[IPFS](https://ipfs.io/) is an open-source program implemented in several programming languages. The Go version, named Kubo, is the most popular implementation.\r\n\r\nIPFS calculates hashes of files or folders to generate Content Identifiers (CIDs), which it then announces over a massive peer-to-peer network. Anyone with a CID can retrieve the corresponding files from the network.\r\n\r\nRunning an IPFS node to host files is straightforward. Simply visit [Kubo's releases page](https://github.com/ipfs/kubo) to download and run the single executable binary file, available for all major operating systems.\r\n\r\nNo single IPFS node holds all files—each node only provides the CIDs it possesses. However, with IPFS nodes distributed worldwide, the entire network can host very large datasets. This technology, known as a distributed hash table, enables several interesting applications:\r\n\r\n* Single file CIDs are used by many NFT projects. Each NFT image corresponds to a CID, and as long as computers host those files, the NFT images remain retrievable.\r\n* CIDs can also represent entire folders, allowing IPFS to host complete websites (which are essentially folders containing HTML, CSS, JavaScript, and other assets). Every website built with the Planet app is identified by a folder CID.\r\n\r\nThis is fundamentally different from HTTP. With HTTP, accessing specific content requires a server address. With IPFS, you only need the CID. The content may reside on any number of peers, not just a single server.\r\n\r\nPlanet includes the IPFS node software, allowing you to publish websites you build with Planet as CIDs. Other IPFS or Planet users can then access them through the distributed network.\r\n\r\n## Local Gateway\r\n\nYou can open any IPFS resource using the local gateway. Under **File**, select **Open IPFS Resource**.\n\n![\"ipfs-open\"](\"ipfs-open.webp\")
\n![\"Uniswap](\"uniswap-cid.png\")
![\"IPNS:](\"ipns-vitalik.eth.png\")
![\"IPNS:](\"ipns-docs.ipfs.tech.png\")
k51qzi5uqu5dgv8kzl1anc0m74n6t9ffdjnypdh846ct5wgpljc7rulynxa74a\r\n\r\nIt can be accessed via the local gateway:\r\n\r\n`http://localhost:18181/ipns/k51qzi5uqu5dgv8kzl1anc0m74n6t9ffdjnypdh846ct5wgpljc7rulynxa74a`\r\n\r\n![\"IPNS:](\"ipns-planetable.eth.png\")
IPFS is an open-source program implemented in several programming languages. The Go version, named Kubo, is the most popular implementation.
\nIPFS calculates hashes of files or folders to generate Content Identifiers (CIDs), which it then announces over a massive peer-to-peer network. Anyone with a CID can retrieve the corresponding files from the network.
\nRunning an IPFS node to host files is straightforward. Simply visit Kubo's releases page to download and run the single executable binary file, available for all major operating systems.
\nNo single IPFS node holds all files—each node only provides the CIDs it possesses. However, with IPFS nodes distributed worldwide, the entire network can host very large datasets. This technology, known as a distributed hash table, enables several interesting applications:
\nThis is fundamentally different from HTTP. With HTTP, accessing specific content requires a server address. With IPFS, you only need the CID. The content may reside on any number of peers, not just a single server.
\nPlanet includes the IPFS node software, allowing you to publish websites you build with Planet as CIDs. Other IPFS or Planet users can then access them through the distributed network.
\nYou can open any IPFS resource using the local gateway. Under File, select Open IPFS Resource.
\n\nThis integrated IPFS node provides several useful local ports.
\nWe have made minor adjustments to the port numbers to prevent conflicts with other programs that may utilize these ports, such as a pre-existing IPFS desktop application.
\nThis port serves as the local gateway. You can use it to access content on the IPFS P2P network. Below are a few examples.
\nFor example, the v4.2.08.0 release of Uniswap:
\nCIDv1: bafybeiepywaseoxbaccdblzm6thhqjelkwbamd3guh24wfzba2wwvz6hve
Access via Local Gateway:
\nhttp://localhost:18181/ipfs/bafybeiepywaseoxbaccdblzm6thhqjelkwbamd3guh24wfzba2wwvz6hve
IPNS is the naming system utilized by IPFS, which can be accessed through the /ipns/ paths as demonstrated below:
\nIf an ENS has its content hash pointing to a resource on IPFS, it can be accessed through an IPFS gateway in the following manner:
\nhttp://localhost:18181/ipns/vitalik.eth
If a DNS name has a DNSLink TXT record pointing to a resource on IPFS, it can be accessed through an IPFS gateway:
\nhttp://localhost:18181/ipns/docs.ipfs.tech/
Blogs and websites published from Planet are IPNS. Other Planet users can simply use Follow Planet to receive the latest updates, or these can also be accessed through the local gateway. For example, the IPNS powered planetable.eth is:
\nk51qzi5uqu5dgv8kzl1anc0m74n6t9ffdjnypdh846ct5wgpljc7rulynxa74a
It can be accessed via the local gateway:
\nhttp://localhost:18181/ipns/k51qzi5uqu5dgv8kzl1anc0m74n6t9ffdjnypdh846ct5wgpljc7rulynxa74a
Kubo, the Go implementation of IPFS, exposes an HTTP RPC API that allows you to control the node and run the same commands that you can run from the command line.
\nYou can access this API on port 5981. For example, the following cURL request would return the Identity of the node:
\ncurl -X POST http://localhost:5981/api/v0/id
Origin isolation is an important security feature for decentralized app front-ends running on IPFS gateways. So, when you try to access a URL like this:
\nhttp://localhost:18181/ipfs/bafybeiepywaseoxbaccdblzm6thhqjelkwbamd3guh24wfzba2wwvz6hve
Kubo will return a redirect to transform the URL into this:
\nhttp://bafybeiepywaseoxbaccdblzm6thhqjelkwbamd3guh24wfzba2wwvz6hve.ipfs.localhost:18181/
However, Safari does not support this kind of URL as of this writing: *.localhost. This is a known issue recorded in the WebKit bug tracking system:
https://bugs.webkit.org/show_bug.cgi?id=160504
\nTo prevent that redirect on Safari, you need to replace localhost with 127.0.0.1 so that the redirect will not occur:
http://127.0.0.1:18181/ipfs/bafybeiepywaseoxbaccdblzm6thhqjelkwbamd3guh24wfzba2wwvz6hve
![\"markdown-editor\"](\"markdown-editor.png\")
Planet has a two-column Markdown editor for easily writing and previewing content. As you write, the preview area on the right automatically updates, allowing you to see the rendered result.
\nYou can attach images, audio, or even video to your post. While there is no limit to attaching images, each post can attach up to one audio or video file.
\nYou can also drag-and-drop media files to the writing area, and they will be attached.
\nGFM (GitHub Flavored Markdown) todo list syntax is supported, making Planet a flexible and powerful tool for organizing to-dos.
\nWhen you enter Markdown like this:
\n- [ ] To Do Item 1\n- [x] To Do Item 2\nThey will be rendered like this:
\n