NoEgo Tutorial
Build a complete full-stack TypeScript application from scratch. Each step builds on the previous one.
Getting Started
Install NoEgo and create your first application scaffold.
Project Structure
Understand the directory layout and configuration files.
Configuration
Understand noego.config.yml and how App wires boot, server, client, and development settings.
Routing with OpenAPI
Define frontend and backend routes with OpenAPI metadata.
Controller Layer
Expose validated API endpoints through controllers.
Service Layer
Add business logic with IoC dependency injection.
Repository Layer
Write SQLStack repositories with co-located SQL queries.
Database Setup
Configure SQLite and create migrations for your schema.
Advanced SQLStack
Use SQLStack repository patterns for more complete data access.
Proper Migrations
Manage database schema changes with Proper.
Frontend + API
Load data, submit forms, and refresh UI with page loaders.
Deployment
Deploy your NoEgo application to production.
What You'll Build
By the end of this tutorial, you'll have a fully functional task management API with a server-rendered UI.
Features
- RESTful API with OpenAPI documentation
- SQLite database with type-safe queries
- Dependency injection for testable code
- Server-rendered Svelte 5 components
- Comprehensive test suite
Technologies Used
Prerequisites
- Node.js 20.11 or higher
- Basic TypeScript knowledge
- Familiarity with REST APIs
- A code editor (VS Code recommended)