Developer tooling for the Simple Platform
Build enterprise applications faster
Simple Platform is an enterprise application development platform built on schema-first principles. Define your data model in human-readable configuration files, and the platform automatically generates:
- ✅ GraphQL APIs — Full CRUD operations, filtering, pagination
- ✅ UI Forms & Lists — Auto-generated from your schema
- ✅ Validation — Same rules run on client AND server (via WebAssembly)
- ✅ Triggers & Webhooks — Schedule actions or respond to events
This repository contains the official developer tools to build, test, and deploy Simple Platform applications.
| Tool | Description | Documentation |
|---|---|---|
| Simple CLI | Command-line interface for scaffolding and building applications | 📖 Full Documentation |
| Contextualizer | CLI to consolidate code for LLM context | 📖 Full Documentation |
| SCL Parser CLI | Standalone CLI for parsing SCL files to JSON | 📖 Full Documentation |
| SCL Parser | Elixir library for SCL parsing | 📖 Full Documentation |
This project is configured with Devbox to ensure a consistent development environment.
- Install Devbox.
- Run
devbox shellat the root of the repository to load all necessary tools (Go, Node.js, Elixir, etc.).
# Clone the repository
git clone https://github.com/simple-platform/simple-tools.git
cd simple-tools
# Build all tools (Simple CLI, SCL Parser CLI)
pnpm build
# Verify installation
./tools/simple-cli/simple --help# Initialize a workspace
./tools/simple-cli/simple init my-first-app
cd my-first-app
# Create an application
../tools/simple-cli/simple new app com.mycompany.hello "Hello World"
# View generated structure
tree apps/For detailed usage, see the Simple CLI Documentation.
Run these from the monorepo root:
| Command | Description |
|---|---|
pnpm build |
Build all tools (JS/Go/Elixir) via Turbo |
pnpm test |
Run all tests (Go/Elixir) via Turbo |
pnpm lint |
Run all linters (JS/Go/Elixir) via Turbo |
pnpm tidy |
Tidy dependencies |
simple-tools/
├── tools/
│ ├── simple-cli/ # Go CLI application
│ ├── contextualizer/ # Go CLI for LLM context
│ └── scl_parser_cli/ # Elixir CLI for SCL Parser
├── packages/
│ └── scl_parser/ # Elixir parser library
├── AGENTS.md # AI coding guidelines
├── package.json # Monorepo scripts
└── pnpm-workspace.yaml # Workspace config
We follow strict engineering standards. Before contributing:
- Read AGENTS.md for coding guidelines
- Write tests — 90%+ coverage on business logic
- Run checks —
pnpm lint && pnpm test - Use conventional commits —
feat:,fix:,docs:, etc.
- Tests pass locally (
go test ./...) - Linting passes (
golangci-lint run ./...) - Coverage maintained/improved
- Documentation updated if needed
| Project | Description |
|---|---|
| Simple SDKs | TypeScript SDK for Actions |
Apache 2.0 — see LICENSE for details.
Built with ❤️ by the Simple Platform team
simple.dev