Browse source code
A modern full-stack .NET 10.0 + Next.js 16 project template that combines the power of ServiceStack with Next.js static site generation and React 19. It provides a production-ready foundation for building scalable web applications with integrated authentication, database management, and background job processing.
npx create-net nextjs MyProjectInstantly scaffold a new App with this template using GitHub Copilot, just describe the features you want and watch Copilot build it!
Run Server .NET Project (automatically starts both .NET and Next.js dev servers):
cd MyProject
dotnet watchDevelopment Mode:
- ASP.NET Core proxies requests to Next.js dev server (running on port 3000)
- Hot Module Replacement (HMR) support for instant UI updates
- WebSocket proxying for Next.js HMR functionality
Production Mode:
- Next.js app is statically exported to
/dist - Static files served directly from ASP.NET Core's
/wwwroot - No separate Node.js server required in production
MyApp/ # Main ASP.NET Core host
├── Configure.*.cs # Modular startup configuration
├── Program.cs # Application entry point
└── wwwroot/ # Static files (production)
MyApp.Client/ # Next.js frontend application
├── app/ # Next.js App Router pages
├── components/ # React components
├── lib/ # Utilities and helpers
├── public/ # Static assets
├── dist/ # Build output (production)
└── styles/ # Tailwind CSS styles
MyApp.ServiceInterface/ # Service implementations
├── MyServices.cs # Example services
└── Data/ # EF Core DbContext
MyApp.ServiceModel/ # DTOs and service contracts
├── Bookings.cs # AutoQuery CRUD example
└── Hello.cs # Example service contract
MyApp.Tests/ # Integration and unit tests
config/ # Deployment configuration
└── deploy.yml # Kamal deployment settings
.github/ # GitHub Actions workflows
└── workflows/
├── build.yml # CI build and test
├── build-container.yml # Container image build
└── release.yml # Production deployment with Kamal
Full ASP.NET Core Identity integration with ServiceStack's Auth features:
- Credentials Authentication - Email/password sign-in with secure cookie sessions
- User Registration - With email confirmation support
- Role-based Authorization - Admin, Manager, Employee roles with
[ValidateHasRole] - Admin Users UI - Built-in user management at
/admin-ui/users - API Keys - Generate and manage API keys for programmatic access
Declarative APIs with automatic query and CRUD functionality:
- AutoQuery - Queryable APIs with filtering, sorting, and pagination
- AutoQueryData - In-memory queryable data sources
- Audit History - Automatic tracking of data changes
- Bookings Example - Complete CRUD example with role-based permissions
Modern UI built with:
- React 19 with Server Components support
- shadcn/ui - Beautiful, accessible component library
- Tailwind CSS 4 - Utility-first styling with dark mode support
- @servicestack/react - Pre-built form components and AutoQueryGrid
- SWR - React Hooks for data fetching with caching
Built-in AI chat capabilities:
- ChatFeature - Multi-provider AI chat API
- Configurable Providers - ServiceStack, OpenAI, Anthropic, Google, Groq, and more
- Chat History - Persistent storage with
DbChatStore - Admin Analytics - Chat usage insights at
/admin-ui/chat
Durable job processing with ServiceStack's Background Jobs:
- Command Pattern - Type-safe job definitions
- Email Queue - SMTP email sending via background jobs
- Recurring Jobs - Scheduled task execution
- Job Dashboard - Monitor jobs at
/admin-ui/jobs
Integrated markdown blog with:
- MDX Support - Markdown with React components
- Syntax Highlighting - Prism.js code blocks
- Static Generation - Pre-rendered at build time
- Frontmatter - YAML metadata for posts
- YouTube Embeds - Custom remark plugin for YouTube videos
- Typography Styling - Beautiful prose with
@tailwindcss/typography
SQLite with dual ORM support:
- OrmLite - ServiceStack's fast micro-ORM for services
- Entity Framework Core - For Identity and complex queries
- Code-First Migrations - EF Core migrations in
/Migrations - Database Admin UI - Browse data at
/admin-ui/database
Comprehensive API logging:
- SqliteRequestLogger - Persistent request logging to SQLite
- Request Body Tracking - Full request payload capture
- Error Tracking - Automatic error logging
- Admin Dashboard - View logs at
/admin-ui/logging
Production-ready health monitoring:
- Health Endpoint -
/upfor load balancer checks - Custom Health Checks - Extensible health check framework
Automatic TypeScript type generation:
- Type-Safe API Calls - Generated from C# DTOs
- Sync Command -
npm run dtosto update types - ServiceStack Client - Full-featured TypeScript client
API documentation with modern tooling:
- OpenAPI 3.0 - Auto-generated API specifications
- Scalar API Reference - Interactive API documentation at
/scalar/v1 - Development Mode - API docs available in development
Comprehensive test coverage:
- Vitest - Fast unit testing for React components
- React Testing Library - Component testing utilities
- jsdom - Browser environment simulation
- Integration Tests - .NET integration tests in
MyApp.Tests
Production-ready containerization:
- Kamal Deployment - Zero-downtime deploys with Kamal
- GitHub Container Registry - Automatic container builds
- SSL Auto-Certification - Let's Encrypt integration
- Volume Persistence -
App_Datavolume mounting for SQLite
Built-in theme support:
- System Preference - Respects OS dark mode setting
- Tailwind CSS 4 - Native dark mode utilities
- Consistent Theming - All components support dark mode
| Page | Description |
|---|---|
/ |
Home page with getting started guide |
/todomvc |
TodoMVC example with ServiceStack APIs |
/bookings-auto |
AutoQueryGrid with automatic columns |
/bookings-custom |
Custom booking form with validation |
/admin |
Protected admin page (requires Admin role) |
/profile |
User profile management |
/posts |
MDX blog listing |
/shadcn-ui |
shadcn/ui component showcase |
/about |
About page (MDX) |
/features |
Template features overview (MDX) |
/privacy |
Privacy policy page (MDX) |
Access built-in admin dashboards at:
/admin-ui- Admin dashboard home/admin-ui/users- User management/admin-ui/database- Database browser/admin-ui/logging- Request logs/admin-ui/jobs- Background jobs/admin-ui/apikeys- API key management/admin-ui/chat- AI chat analytics