Template: Axum / SolidJS SPA

Backend

• Axum
• PostgreSQL
• Mimalloc

Frontend

• SolidJS + Solid Router
• TypeScript
• Tailwind CSS v4
• Bun
• Vite

Getting Started

• Clone the repository: git clone https://github.com/robertwayne/template-axum-solidjs-spa

• Change .env.TEMPLATE to .env and set your Postgres credentials (if not using defaults).

• Install your dependencies with bun i.

• Build the client with bun run build from inside the /client directory. Alternatively, you can use bun dev to run the client with the vite dev server.

• Run the server with cargo run from inside the /server directory.

  • If you're serving from axum, visit http://127.0.0.1:3000.
  • If you're serving from vite, visit http://127.0.0.1:8000.

Client Notes

• Async, naive prefetching for route links.
• Light/Dark mode themes built-in.
• Responsive navigation menu built-in.

Server Notes

• Sets default Cache-Control headers via a middleware function.
• Uses tower-http CORS and Compression (brotli) middleware.
• Uses mimalloc instead of the default allocator.

Remember, this is a template. Make sure you review the code and adjust it to your projects needs.

Additional Scripts

Command	Action
./update.sh	Updates the dependencies of both the client and server projects.