Step 1 of 12 8% complete

Step 1: Getting Started

What You'll Learn

Create a new NoEgo project structure
Install the @noego/app toolchain
Run the development server

What You'll Build

A running NoEgo development server with hot reload enabled.

Prerequisites

Before we begin, make sure you have Node.js 20.11 or higher installed. Verify your version by running:

terminal

node --version

Creating Your Project

Create a new project folder and initialize npm:

terminal

mkdir my-app
cd my-app
npm init -y

Install the NoEgo packages and dev tooling:

terminal

npm install @noego/app @noego/dinner @noego/forge @noego/ioc sqlstack
npm install -D vite @sveltejs/vite-plugin-svelte svelte typescript tsx

We’ll add configuration and starter files in the next steps.

Project Structure

project structure

my-app/
├── server/                   # Backend TypeScript code
│   ├── boot.ts               # Express app bootstrap
│   ├── server.ts             # NoEgo server entry
│   ├── controller/           # HTTP controllers
│   ├── service/              # Business logic
│   ├── repo/                 # Database access
│   └── openapi/              # API route definitions
├── frontend/                 # Svelte UI code
│   ├── client.ts             # NoEgo client entry
│   ├── index.html            # HTML shell template
│   ├── pages/                # Page components
│   ├── layout/               # Page layouts
│   ├── component/            # Reusable components
│   ├── lib/                  # Frontend utilities
│   └── openapi/              # UI route definitions
├── migrations/               # Database migrations
├── noego.config.yml          # NoEgo configuration
├── package.json              # Dependencies
└── tsconfig.json             # TypeScript config

Install & Run

Once your configuration and entry files are in place, start the dev server:

terminal

npx noego dev

You should see:

terminal output

✓ Server running at http://localhost:3000
✓ Watching for file changes...

Open http://localhost:3000 in your browser to see your NoEgo application running.

What's Next

In the next step, we’ll set up the configuration file and walk through the project structure in detail.

Troubleshooting

All Steps Next Step