Claim a subdomain like myproject.is-a.software and point it to your website with custom DNS records (A, AAAA, CNAME, TXT, MX, NS). Built with a Java/Spring Boot backend and a Next.js frontend.
# Backend
cd server
cp src/main/resources/application.properties.example src/main/resources/application.properties
# edit application.properties with your DB credentials
./mvnw spring-boot:run
# Frontend
cd client
cp .env.local.example .env.local
npm install
npm run dev.
├── server/ # Java 21 / Spring Boot 4.0.3 backend
│ ├── src/main/
│ │ ├── java/.../controller/ # REST controllers
│ │ ├── java/.../service/ # Business logic
│ │ ├── java/.../entity/ # JPA entities
│ │ ├── java/.../repository/ # Data access
│ │ ├── java/.../security/ # JWT auth
│ │ └── resources/ # Config
│ └── pom.xml
├── client/ # Next.js 16 / React 19 frontend
│ ├── app/ # App Router pages
│ ├── components/ # React components
│ ├── lib/ # API client & auth utilities
│ └── package.json
├── ARCHITECTURE.md # Architecture deep-dive
├── CONTRIBUTING.md # How to contribute
├── DOCS.md # End-user guide (how to get a subdomain)
├── LICENSE
└── SECURITY.md # Security policy
| File | What it covers |
|---|---|
| ARCHITECTURE.md | Tech stack, entity model, security flow, key design decisions |
| DOCS.md | Step-by-step guide with platform examples |
| CONTRIBUTING.md | Setup, coding conventions, submitting PRs |
| SECURITY.md | Vulnerability reporting |
MIT — see LICENSE.