Note:

HeliumTS is under pre-beta and active development. Expect bugs and breaking changes. If you find any issues, please report them in our GitHub

A stable release is planned for early December 2025.

Project Structure

A typical HeliumTS project looks like this:

1src/
2  pages/             # Client-side pages (Next.js pages router style)
3    index.tsx
4    [id].tsx         # Dynamic routes
5    [...slug].tsx    # Catch-all routes
6    _layout.tsx      # Root layout
7    (protected)/     # Route group (e.g., for auth)
8      dashboard.tsx
9  server/            # Server-side logic
10    tasks.ts         # RPC methods for tasks
11    auth.ts          # Auth-related methods
12    webhooks.ts      # Webhook HTTP handlers
13    _middleware.ts   # Server middleware
14  components/        # React components
15  types/             # Shared types
16helium.config.ts     # Helium configuration
17package.json         # NPM package file
18vite.config.ts       # Vite configuration