jakmaz / elynext

Starter for fast and modern full stack development

ElyNext - Modern Full Stack Starter

A simple starter fullstack todos app built with Next.js and ElysiaJS using Bun. This project is purposefully kept minimal to serve as a starting point for beginner to intermediate developers.

💻 Client

Uses the following tech stack:

• 🌐 Web Framework: Next.js (React)
• 🖌️ UI: NextUI
• 🎨 Styling: TailwindCSS
• 🛠️ Icons: Heroicons
• 🔧 Tooling: Bun

🌐 Server

Uses the following tech stack:

• 🏃 Runtime: Bun
• 🌐 Server Framework: Elysia
• 🗄️ DB: SQLite
• 🛠️ ORM: Drizzle
• ✅ Validation: Typebox
• 🔄 End-to-End Type Safety: Eden

📋 Features

• 📝 Backend Unit Tests: Comprehensive unit tests for backend routes
• 💾 Drizzle Kit Integration: Seamless database migrations and schema management.
• 📖 Swagger Documentation: Auto-generated API documentation with Swagger for easy API exploration and testing.

🚀 Usage

📦 Installing Dependencies

Run this command from the root directory:

bun install

🟣 Starting Backend

To start the Elysia server, run this command from the root directory:

bun dev:backend

🔵 Starting Frontend

To start the Next.js dev server, run this command from the root directory:

bun dev:web

🖥 Running Backend and Frontend in Split Window

To run both the backend and frontend in split windows, you need to have tmux installed. Use the following command from the root directory:

bun dev

🧪 Backend Unit Tests

To run the backend unit tests, use the following command in backend directory:

bun test

🔧 Drizzle Kit Integration

To run database migrations using Drizzle Kit, use the following commands:

• Generate migration:

  drizzle-kit generate:migration

• Run migrations:

  drizzle-kit migrate

📖 Swagger Documentation

The Swagger documentation is auto-generated and can be accessed at:

http://localhost:4000/swagger

👨‍💻 Show your Support

Give a ⭐️ if this project helped you!