Spacestate
Jump to navigation
Jump to search
| Spacestate | |
|---|---|
| Status | Active |
| Type | Web service / API |
| Maintainers | NinjaLikesCheez |
| Started | October 2026 |
| Runs on | Azure Container Apps |
| Source | pixelbar/spacestate |
| Docs | pixelbar.nl/spacestate |
Spacestate is the little service that knows whether Pixelbar is open or closed. It stores the current state, keeps a history of changes, and serves the SpaceAPI document that directories and apps use to show our status.
It's a TypeScript rewrite of the old SpaceAPI and spacestate PHP scripts.
 | Spacestate is often confused with the Spacestate Switch, which is a physical button that notifies this service when someone presses it to open or close the hackerspace. |
What it does
- Reports whether the space is open or closed
- Allows external state changes via the API
- Keeps a history of state changes
- Serves our SpaceAPI document, which is how hackerspaces around the world declare their attributes
Links
- Docs and API reference: https://pixelbar.nl/spacestate/
- OpenAPI spec: https://spacestate.pixelbar.nl/openapi.yaml
- Live service: https://spacestate.pixelbar.nl
- Source code: https://github.com/pixelbar/spacestate
- Changelog: https://github.com/pixelbar/spacestate/blob/main/CHANGELOG.md
Good to know
- Reading the state is open to everyone. Changing it needs an API key, which the maintainer & board hands out.
- New integrations should use the REST endpoints. The legacy endpoints are temporary and only there for older hardware while a migration is in process.
- It runs on Azure Container Apps, set up with Terraform. Releases and deploys go through GitHub Actions; the GitHub repo is the source of truth
Who to ask
Ping the maintainer listed above, or open an issue on GitHub.