Five-minute tour - Point docs

Summary

This tour shows Point's daily moves: logic, capabilities, app, and agent repair — in under five minutes.

Start with Point in 60 seconds if you want the shortest path.

1. Logic (30 seconds)

module TourLogic

record Cart Item
  unit price: Int
  quantity: Int

calculation line total
  input item: Cart Item
  output total: Int
  total is item.unit price * item.quantity

point check tour.point

Logic-only modules validate with point check. No command block needed yet.

2. Capabilities (30 seconds)

Import batteries in one line:

module Demo

capabilities http json time

calculation noop
  output value: Text
  return "ok"

point capabilities
point box src/app.point

Same as separate use http lines. The compiler merges only symbols you reference.

3. App surface (2 minutes)

Scaffold a runtime-native app:

point create my-app
cd my-app
point dev src/app.point

Open the URL printed by point dev. The default runtime-app serves SSR pages, forms, navigation, and JSON routes from one src/app.point file, without a Vite/React host.

Full walkthrough: Golden app demo.

Run a CLI command from the template:

point launch src/app.point admin demo

4. Domain outcomes (1 minute)

Model success and failure with variants — not generic Result:

variant Payment Outcome
  Succeeded with charge id: Text
  Failed with message: Text

label outcome message
  input outcome: Payment Outcome
  output Text
  on Succeeded with charge id return "Paid " + charge id
  on Failed with message return message

See Domain outcomes.

5. Agent loop (1 minute)

The compiler is the agent's IDE:

point check-json src/app.point
point repair-plan src/app.point
point index src/app.point