Skip to main content
A project is the top-level organizational unit in Springwinter. Every resource you deploy — web servers, workers, static websites, caches, databases, and storage buckets — lives inside a project. Each project has one immutable AWS Region and an AWS connection, and shares access with your organization, making it easy to keep related services together and manage them as a unit.

What a Project Contains

Each project can hold any combination of the following resource types:
  • Web servers — containerized HTTP services with a public URL, running on ECS.
  • Workers — background ECS processes with no public URL.
  • Static websites — files built from GitHub and served via S3 + CloudFront.
  • Caches — Valkey (Redis-compatible) instances running in your AWS account.
  • Databases — PostgreSQL or MySQL instances managed by AWS RDS.
  • Storage buckets — private S3 buckets with metrics and cost tracking.
All resources inside a project share the same AWS account connection and are visible to every team member with access to that project.

Hostname Suffix

Every web server keeps a generated managed hostname under <project-id>.apps.springwinter.dev. An optional custom hostname suffix adds a second hostname. It does not replace the managed URL. Workers have no public URL, and static websites use CloudFront endpoints. You can update the hostname suffix at any time using the API:
A custom hostname requires customer DNS records and ACM validation. Keep the generated managed URL available while configuring it. An active custom certificate can block a suffix change with certificate_active; review certificate settings first. Do not claim HTTPS is ready until the certificate is validated and attached.

Enabling HTTPS

Springwinter can provision an AWS Certificate Manager (ACM) certificate for your project’s load balancer, enabling HTTPS for all web servers in the project. To enable HTTPS, send a request to the certificate endpoint:
Springwinter requests the certificate from ACM and attaches it to the project load balancer automatically. To disable HTTPS and remove the certificate:
ACM certificate provisioning requires DNS validation. Springwinter will provide the CNAME records you need to add to your DNS provider. The certificate becomes active once DNS validation completes.

Creating a Project

1

Open the dashboard

Sign in at springwinter.dev and navigate to the main dashboard.
2

Click New Project

Select New Project in the top-right corner of the projects list.
3

Name your project

Enter a project name and choose its AWS Region. The Region cannot be changed later; create a separate project when you need another Region.
4

Confirm creation

Click Create Project. Springwinter provisions the project and takes you to the project overview, where you can start adding resources.

Deleting a Project

You can only delete a project that contains no resources. Before deleting, remove all web servers, workers, static websites, caches, databases, and storage buckets from the project. Once the project is empty, send:
Project deletion starts an asynchronous infrastructure cleanup. Follow the returned workflow until completion. Existing resources block deletion; remove previews and resources first. Do not assume an accepted DELETE has completed cleanup.

API Reference

The following endpoints let you manage projects programmatically. All requests require an Authorization: Bearer <token> header or an active cookie session with a CSRF token.