Guides
Start with a working application, then follow the APIs it uses. Install and run a sample if this is your first visit.
Build an application
| I want to… | Start here | Then explore |
|---|---|---|
| Call or serve an HTTP API | Web and HTTP | Server and JSON case |
| Query a PostgreSQL database | SQL databases | Runnable PostgreSQL case |
| Read files and text | Files and storage | Streams |
| Coordinate operations | Tasks and async | Cancellation and timers |
| Publish native code | Native compilation | Performance measurements |
Work with data
- Collections and queries — lists, maps, sets and transformations.
- Arrays and indexing and slicing.
- JSON — nodes, models and serialization.
- Strings and UTF-8 — characters and explicit encoding.
- Configuration — layered settings, sections and DI.
- Localization — JSON resources, scoped lookup and fallback.
- Dates and times and globalization.
- Optional and Result — absence and expected errors.
- Error handling — domain errors, propagation and optional context diagnostics.
Understand the platform
Read Raven for neoCLR for the language used in the examples. Coming from C#? The .NET comparison explains familiar concepts and deliberate differences.
Reference types and value types explain copying, identity, boxing and equality. Modules organize declarations. Introspection describes them; reflection can construct objects and invoke members. neoIL demonstrates the runtime contracts in executable IL, including structural function types. Architecture explains the compiler and runtime layers.
Go deeper when you need to
Use the API reference for exact signatures, errors and limits. Specialized guides cover TCP networking, TLS, native interop, garbage collection and metadata. Proposals describe ideas that are not implemented contracts.