Prerequisites
Before you begin, make sure you have:
- Simplex Runtime: v0.1.0 or later (installation guide)
- Node.js: v18 or later (for development tools)
- Git: For cloning the repository
AI Features (Optional)
To use AI content features, you'll need an API key from Anthropic, OpenAI, or another supported provider. AI features work without configuration in development mode using mock responses.
Installation
Clone the repository
Get the latest version of Aether from GitHub.
git clone https://github.com/senuamedia/aether.git
cd aetherInstall dependencies
Install Simplex packages and build the project.
simplex install
simplex buildStart the development server
Launch Aether in development mode with hot reload.
simplex run
# Aether is now running at http://localhost:8080
# Admin interface at http://localhost:8080/adminCreate Your First Site
Use the CLI to create a new site, or use the admin interface at
http://localhost:8080/admin.
# Create a new site
aether site create my-blog \
--title "My Blog" \
--theme starter \
--language en
# Output:
# ✓ Site 'my-blog' created successfully
# ✓ Applied theme 'starter'
# ✓ Created default content types
#
# Next: aether site use my-blogAdd Content
Create your first piece of content using the CLI or admin UI.
# Switch to your site context
aether site use my-blog
# Create a new article
aether content create article \
--title "Welcome to Aether" \
--body "This is my first post!" \
--status published
# Or let AI generate content
aether ai generate article \
--prompt "Write a blog post about getting started with Aether CMS" \
--publishPreview Locally
The development server automatically rebuilds when content changes.
Open http://localhost:8080 to see your site.
# Build static files for preview
aether build
# Serve the built site
aether serve
# Or use any static file server
npx serve dist/Deploy to Production
Deploy your static site to any hosting provider. Here's how to deploy to AWS S3:
# Configure deployment target
aether deploy config \
--provider aws-s3 \
--bucket my-blog-bucket \
--region us-east-1 \
--cloudfront-id EXAMPLEID
# Build and deploy
aether deploy
# Output:
# ✓ Built 42 pages
# ✓ Optimized 15 images
# ✓ Uploaded to s3://my-blog-bucket
# ✓ Invalidated CloudFront cache
#
# Site live at: https://my-blog.example.com