discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens

neizsche/canihavesex.today · source

Snapshot 0 · 2026-11-04T12:47:28Z · TypeScript · AGPL-3.0

GitHub description at capture

Self-hosted, open-source period & fertility tracker. Private by design — no ads, no tracking.

README at capture

<p align="center">
  <img src=".github/assets/og.png" width="720" alt="canihavesex.today — Am I fertile today? One calm answer." />
</p>

<p align="center">
  A private, open-source period &amp; fertility-awareness app.<br />
</p>

<p align="center">
  <a href="LICENSE"><img src="https://img.shields.io/badge/License-AGPL_v3-blue.svg" alt="License: AGPL v3" /></a>
  <a href="#self-hosting"><img src="https://img.shields.io/badge/self--host-Docker-2496ED?logo=docker&logoColor=white" alt="Self-host with Docker" /></a>
  <a href="#what-it-is"><img src="https://img.shields.io/badge/PWA-installable-5A0FC8?logo=pwa&logoColor=white" alt="PWA" /></a>
  <a href="CONTRIBUTING.md"><img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs welcome" /></a>
</p>

<p align="center">
  <a href="https://canihavesex.today/?utm_source=github&utm_medium=readme"><strong>canihavesex.today</strong></a>
  &nbsp;·&nbsp;
  <a href="https://app.canihavesex.today/?demo=1"><strong>Live demo</strong></a>
  &nbsp;·&nbsp;
  <a href="#self-hosting"><strong>Self-host</strong></a>
</p>

> Not medical advice, and not a contraceptive. See the [Disclaimer](#disclaimer).

## What it is

**[canihavesex.today](https://canihavesex.today/?utm_source=github&utm_medium=readme) is a self-hosted, open-source period tracker** — a private,
privacy-first alternative to mainstream cycle apps. No ads, no tracking, no data-harvesting.

From the signals you log (bleeding, basal body temperature, cervical fluid, LH tests),
one open-source engine estimates today's fertility status alongside your cycle context —
cycle day, fertile window, next-period estimate. When the signal is unclear, it assumes
you're fertile; it never implies contraceptive safety. It's grounded in the
[symptothermal method](https://canihavesex.today/methodology?utm_source=github&utm_medium=readme).

- **Fertility-led and honest** — today's status is the headline, never a false sense of safety.
- **Calm and minimal** — no ads, no upsells, no gamification.
- **Yours** — your data stays on your own instance. Self-host it in minutes.

## Features

- Daily logging — flow, BBT, cervical fluid, LH tests, plus mood, energy, sleep, libido, notes
- Today's fertility status with a confidence signal, and cycle context (calendar, trends)
- Email + password out of the box; Google / OIDC optional
- CSV export of your own data
- Mobile-first PWA, light and dark themes

## Demo

<p align="center">
  <a href="https://app.canihavesex.today/?demo=1">
    <img src="https://img.shields.io/badge/Try%20the%20Live%20Demo%20%E2%86%92-5A0FC8?style=for-the-badge&logo=pwa&logoColor=white&labelColor=1a1a1a" alt="Open the live demo" />
  </a>
</p>
<p align="center">
  <em>Drops you straight into a sample account, no signup needed.</em>
</p>

## Self-hosting

The easiest path is Docker. One app container + Postgres, configured by a single `.env`.

```bash
docker pull ghcr.io/neizsche/canihavesex:latest
```

```bash
curl -O https://raw.githubusercontent.com/neizsche/canihavesex.today/main/docker-compose.yml
```

```bash
printf 'COOKIE_SECRET=%s\nPOSTGRES_PASSWORD=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 16)" > .env
```

```bash
docker compose up -d
```
**Next steps:** Open <http://localhost:3112>. Email/password works out of the box. Database migrations run automatically. (Optional: Set Google/OIDC variables in `.env` to enable SSO).

<details>
<summary><strong>Maintenance Commands</strong></summary>

<br/>

| Action             | Command                                                                                               |
| :----------------- | :---------------------------------------------------------------------------------------------------- |
| **Update**         | `docker compose pull && docker compose up -d`                                                         |
| **Backup**         | `docker compose exec db pg_dump -U canihavesex canihavesex > backup.sql`                              |
| **Restore**        | `cat backup.sql \| docker compose exec -T db psql -U canihavesex canihavesex`                         |
| **Reset Password** | `docker compose exec app node apps/backend/dist/scripts/resetPassword.js user@email.com new_password` |

</details>



## Learn more

- [Methodology](https://canihavesex.today/methodology?utm_source=github&utm_medium=readme) — the science behind today's status
- [Privacy](https://canihavesex.today/privacy?utm_source=github&utm_medium=readme) — what we store, and what we never do
- [Why open source](https://canihavesex.today/open-source?utm_source=github&utm_medium=readme) — transparency and self-hosting

## Disclaimer

This is fertility-awareness software. It is **not medical advice** and **not a
contraceptive**, and it does not guarantee pregnancy prevention. When in doubt, assume you
are fertile, and consult a healthcare professional for medical decisions.

## Contributing & License

Contributions welcome — see [CONTRIBUTING.md](./CONTRIBUTING.md). Licensed under
[GNU AGPL-3.0](./LICENSE): run a modified version as a network service and you must share
your source under the same license. Running it privately for a single household does not
trigger that requirement.