Loading...
Loading...
Learn how to create and structure Steedos projects using Node.js/TypeScript. Covers minimal project requirements, package.json configuration, steedos-config.yml setup, directory structure, environment variables, and installation procedures. Use when creating a new Steedos project or understanding project organization.
npx skill4agent add steedos/steedos-platform project-formatmy-steedos-project/
├── package.json # NPM package configuration (REQUIRED)
├── steedos-config.yml # Steedos configuration (REQUIRED)
├── .env # Environment variables (RECOMMENDED)
├── .gitignore # Git ignore rules
└── steedos-packages/ # Custom packages (OPTIONAL)
└── my-package/
└── ...{
"name": "my-steedos-project",
"version": "0.0.1",
"private": true,
"workspaces": [
"steedos-packages/*"
],
"scripts": {
"start": "steedos start",
"build": "lerna run build"
},
"dependencies": {
"@steedos/server": "latest"
}
}@steedos/serverworkspacesstart# Empty file is acceptable
# Or add configuration:
metadata_packages:
- '@steedos-packages/my-package'# Server Configuration
PORT=5100
ROOT_URL=http://localhost:5100
# Database
MONGO_URL=mongodb://127.0.0.1:27017/steedos
# Message Queue & Cache
TRANSPORTER=redis://127.0.0.1:6379
CACHER=redis://127.0.0.1:6379/1
# Storage
STEEDOS_STORAGE_DIR=./steedos-storage
# Logging
B6_LOG_LEVEL=warnmy-steedos-project/
├── package.json # NPM configuration
├── steedos-config.yml # Steedos configuration
├── .env # Environment variables
├── .gitignore # Git ignore
├── yarn.lock / package-lock.json # Dependency lock file
├── node_modules/ # Dependencies
├── steedos-storage/ # File storage
└── steedos-packages/ # Custom packages
├── package-1/
│ ├── package.json
│ ├── package.service.js
│ └── main/default/
│ ├── objects/
│ ├── applications/
│ ├── triggers/
│ └── pages/
└── package-2/
└── ...mkdir my-steedos-project
cd my-steedos-projectnpm init -y
# Edit package.json to add required fieldstouch steedos-config.ymlcat > .env << EOF
PORT=5100
ROOT_URL=http://localhost:5100
MONGO_URL=mongodb://127.0.0.1:27017/steedos
TRANSPORTER=redis://127.0.0.1:6379
CACHER=redis://127.0.0.1:6379/1
STEEDOS_STORAGE_DIR=./steedos-storage
B6_LOG_LEVEL=warn
EOFnpm install @steedos/server
# or
yarn add @steedos/servernpm start
# or
steedos start# Install CLI
npm install -g @steedos/cli
# Create project
steedos create my-project
cd my-project
# Start
npm start{
"name": "my-steedos-project",
"private": true,
"workspaces": [
"steedos-packages/*"
]
}# Dependencies
node_modules/
.yarn/
.pnp.*
# Environment
.env
.env.local
# Storage
steedos-storage/
.steedos/
# Logs
logs/
*.log
# Build
dist/
build/
.cache/
# IDE
.vscode/
.idea/
*.swp
*.swopackage.jsonsteedos-config.yml.gitignorenode_modules/.env.env.env@steedos-packages/[name]yarn.lockpackage-lock.json# Start development server
npm start
# Build packages
npm run build
# Install dependencies
npm install
# or
yarn install
# Add new package
cd steedos-packages
mkdir my-package
cd my-package
npm init -ysteedos-config.yml.envsteedos-config.ymlPORT.envlsof -ti:5100 | xargs kill