fern-api/spring-starter

A starter repo for Java Spring, using Fern

Spring + Fern starter repo

This repo is a starter repo for building a Spring server using Fern.

Fern is an open source format for defining REST APIs. Fern makes it easy to:

1. Define your API
2. Implement your API on the backend
3. Consume your API on the frontend

Quick start

Step 1: Fork this repo

Step 2: Clone your fork

Step 3: Generate code

Most of the code for this server is auto-generated by Fern!

In a terminal, run:

npm install -g fern-api
fern generate

Step 4: Run the backend

./gradlew bootRun

Now you can cURL the server!

curl 'http://localhost:8080/movies/goodwill-hunting'

Development

To get started, open a VSCode window for the root of this repo:

./gradlew idea && open *.ipr

Auto-generated server code

Nearly all of the server code is generated by Fern when you run fern generate. The generated code lives in src/main/java/com/example/generated.

In addition to saving you time, the auto-generated code gives you compile-time safety that your API is implemented correctly.

Changing the API

The API is defined using Fern. The definition lives in the fern/ directory. You can edit these YAML files to update the API. Check out the docs to read more about defining APIs.

Most of the server code in this repo is automatically generated by Fern. You can regenerate the code using the Fern CLI:

npm install -g fern
fern generate

This will output newly generated code to src/main/java/com/example/generated.

When you change your API, you'll get compile errors if you're not implementing the API correctly.

Issues & contributing

If you run into any problems while using this ticket, plesae file an issue. Of course, PRs are welcome and encouraged!