An architecture designed to accelerate PoC development with reusability, scalability, and clarity for both human developers and AI agents.
import React from 'react';
import { NextApp } from 'next/app';
export default function App({ Component, pageProps }) {
return <Component {... pageProps} />;
}# Clone the repository
git clone https://github.com/user/hyma-poc-boilerplate
# Install dependencies
npm install
# Run development server
npm run devDesigned for quick setup with best practices and necessary tooling built in.
Per-component folders for modularity and maintainability in /src/components/ui/
API routes with middleware via next-connect in /src/app/api/
Type-safe database access with SQLite default and PostgreSQL support
Faster, less bloated linting and formatting replacing ESLint/Prettier
Built-in security with X-Content-Type-Options, X-Frame-Options, X-XSS-Protection
Multi-stage Dockerfile with non-root user and docker-compose setup
Vitest for unit tests, Playwright for E2E tests with example setup
Predefined folders and memory bank system for AI context tracking
Check out the demo pages to understand key concepts like component structure, API routes, and state management.
Browse the Docusaurus documentation to understand architecture decisions and usage guidelines.
Add new components following the isolation pattern in /src/components/ui/[ComponentName]/.
SQLite is configured by default. Use Prisma commands to create models and run migrations.
Add new API endpoints in /src/app/api/ following the route handler pattern.
Add unit tests with Vitest and E2E tests with Playwright to ensure quality.