newOS for Developers

Getting Started

Set up your local NewOS development environment.

Prerequisites

RequiredNode.js 18+ and pnpm

RequiredGit CLI

OptionalGitHub CLI (gh) for repository access

Installation

1. Clone the repository

git clone https://github.com/new-foundation/newos-web.git
cd newos-web

2. Install dependencies

pnpm install

3. Set up environment

cp apps/web/.env.example apps/web/.env.local
# Edit .env.local with your API keys

Environment Variables

NEXT_PUBLIC_NEWGRAPH_API_URL

Newgraph API endpoint

NEXT_PUBLIC_FIREBASE_CONFIG

Firebase config for auth

NEXT_PUBLIC_SITE_URL

Your deployment URL

Running the Dev Server

cd apps/web
pnpm dev

# Open http://localhost:3000

Project Structure

newos-web/
├── apps/
│   └── web/                 # Main Next.js app
│       ├── Components/      # UI components
│       ├── hooks/           # React hooks
│       ├── pages/           # Next.js routes
│       └── utils/           # Helper functions
└── packages/
    └── newgraph-signals/    # API client library
        └── src/actions/     # API action modules

Next Steps

Explore ChatInput

The primary AI chat interface

Understand Folder/Mood

Container for spaces and chats

Learn PostWidget

Content display and voting