Quick Start — Deploy in 5 Minutes

1. Install NovaServe

npm install -g novaserve

2. Scaffold a New Project

nova init my-first-app
cd my-first-app && npm install

This creates a new project with the following structure:

my-first-app/
├── App.ts              # Application & resource definitions
├── nova.config.ts      # Compiler & deployment configuration
├── package.json
└── tsconfig.json

3. Write Your First Function

Open App.ts and define an HTTP endpoint:

1import { defineApp, api } from "novaserve";
2
3export const app = defineApp({ name: "my-first-app" });
4
5export const hello = api.get("/api/hello", async () => {
6  return {
7    message: "Hello from NovaServe!",
8    timestamp: Date.now(),
9  };
10});

4. Run the Local Emulator

Start the sub-200ms local development sandbox:

nova dev

5. Test Your Endpoint

In a new terminal, send a request to your local API:

curl http://localhost:3000/api/hello

Expected response:

{
  "message": "Hello from NovaServe!",
  "timestamp": 1723764000000
}

6. Deploy to AWS

When you're ready, deploy to production:

nova deploy --target aws

NovaServe automatically parses your TypeScript AST, synthesizes least-privilege IAM policies, generates the execution plan, and provisions your Lambda functions, API Gateway, and any declared resources.

What's Next?

• Project Structure — understand file organization
• Compiler Pipeline — how AST transformation works
• Build a REST API — full guide with storage and queues
• CLI Reference — all available commands