Build and host decentralized websites from your Mac

API
 
Planet API Server

Planet includes a RESTful API server, which can be enabled in the settings for some use cases.

Enable from Settings

Click the Planet item in the menu bar, and select Settings:

planet-menu-settings

Switch to the API tab and click Start Server. The server will start listening on the selected port; by default, it is 8086.

planet-start-server

API Endpoints

The full list of API endpoints is available in the following document:

https://github.com/Planetable/Planet/blob/main/Technotes/API.md

Currently, the API server supports the following basic operations:

  • List sites
  • Create site
  • Delete site
  • Publish site
  • List articles
  • Create article
  • Update article
  • Delete article

Experimental iOS Client

An experimental iOS client is currently available via TestFlight:

https://testflight.apple.com/join/I4tSZmug

The client needs to talk to an API server to work.

Experimental Web Client

planet-web

This is an experimental web client created using vanilla JS and HTML/CSS.

https://github.com/livid/planet-web

It has not been optimized for mobile yet.

You need to clone the repo into Planet's public folder to get it to work.

cd ~/Library/Containers/xyz.planetable.Planet/Data/Documents/Planet/Public/
git clone https://github.com/livid/planet-web app

If you are using Croptop, you need to use this location:

cd ~/Library/Containers/xyz.planetable.Lite/Data/Documents/Planet/Public/
git clone https://github.com/livid/planet-web app

It can then be accessed at this address:

http://localhost:8086/app/

Reach the API Server From Anywhere

If you are away from your computer but want to access the Planet API server running on it, the easiest way is to install Tailscale on your devices.

https://www.tailscale.com/

Tailscale creates a magic LAN that connects all your devices.

It is free for personal use.

API