expopush.github.io/index.html at main · expopush/expopush.github.io · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Expo Push — Spring Boot starter for Expo push notifications</title>
<meta name="description" content="A high-performance, enterprise-ready Spring Boot starter for sending push notifications via Expo, with pluggable backends and delivery-receipt tracking.">
<style>
  :root {
    --bg: #fafaf8; --fg: #1c1c1a; --muted: #6b6b66; --line: #e4e4df;
    --accent: #1a56db; --card: #ffffff; --code-bg: #f1f1ec;
  }
  @media (prefers-color-scheme: dark) {
    :root {
      --bg: #17181a; --fg: #e8e8e4; --muted: #9a9a94; --line: #2c2d30;
      --accent: #7aa2f7; --card: #1f2023; --code-bg: #232428;
    }
  }
  * { box-sizing: border-box; margin: 0; }
  body {
    background: var(--bg); color: var(--fg);
    font: 17px/1.65 ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
    -webkit-font-smoothing: antialiased;
  }
  main { max-width: 44rem; margin: 0 auto; padding: 4.5rem 1.5rem 3rem; }
  h1 { font-size: 2.4rem; line-height: 1.15; letter-spacing: -0.02em; }
  h1 span { color: var(--accent); }
  .tagline { margin-top: 0.9rem; font-size: 1.15rem; color: var(--muted); max-width: 36rem; }
  h2 { margin: 2.8rem 0 0.9rem; font-size: 1.05rem; text-transform: uppercase;
       letter-spacing: 0.08em; color: var(--muted); font-weight: 600; }
  pre {
    background: var(--code-bg); border: 1px solid var(--line); border-radius: 8px;
    padding: 1rem 1.2rem; overflow-x: auto; font-size: 0.85rem; line-height: 1.55;
  }
  code { font-family: ui-monospace, "SF Mono", Menlo, Consolas, monospace; }
  ul.features { list-style: none; padding: 0; display: grid; gap: 0.55rem; }
  ul.features li { padding-left: 1.4rem; position: relative; }
  ul.features li::before { content: "→"; position: absolute; left: 0; color: var(--accent); }
  .repos { display: grid; gap: 0.8rem; padding: 0; list-style: none; }
  .repos a {
    display: block; background: var(--card); border: 1px solid var(--line);
    border-radius: 10px; padding: 0.9rem 1.1rem; text-decoration: none; color: inherit;
    transition: border-color 120ms ease;
  }
  .repos a:hover { border-color: var(--accent); }
  .repos strong { color: var(--accent); font-family: ui-monospace, Menlo, monospace; font-size: 0.95rem; }
  .repos span { display: block; color: var(--muted); font-size: 0.92rem; margin-top: 0.15rem; }
  a { color: var(--accent); }
  footer { margin-top: 3.5rem; padding-top: 1.5rem; border-top: 1px solid var(--line);
           font-size: 0.8rem; color: var(--muted); }
</style>
</head>
<body>
<main>
  <h1><span>Expo Push</span> for Spring Boot</h1>
  <p class="tagline">A high-performance, enterprise-ready starter for sending push
  notifications via <a href="https://expo.dev">Expo</a> — pluggable backends,
  delivery-receipt tracking, and honest at-least-once semantics.</p>

  <h2>Get started</h2>
  <pre><code>&lt;dependency&gt;
    &lt;groupId&gt;dev.expopush&lt;/groupId&gt;
    &lt;artifactId&gt;expo-push-spring-boot-starter&lt;/artifactId&gt;
&lt;/dependency&gt;</code></pre>
  <p style="margin-top:0.7rem; font-size:0.95rem;">Full setup, configuration reference, and
  examples live in the <a href="https://github.com/expopush/expo-push#readme">expo-push README</a>.</p>

  <h2>Why this starter</h2>
  <ul class="features">
    <li>Three backends: <strong>SQS</strong> for scale, <strong>H2</strong> for single-node
        persistence, <strong>in-memory</strong> for development</li>
    <li>Full delivery lifecycle: tickets, receipt polling, and five precisely-defined
        terminal outcomes with explicit duplicate-risk semantics</li>
    <li>AES-GCM payload encryption at rest on persistent backends</li>
    <li>Resilient consumers: DLQ-friendly poison handling, schema-versioned messages,
        credential-failure backoff, Retry-After-aware rate limiting</li>
    <li>Optional Micrometer metrics — counters, timers, and queue-depth gauges</li>
  </ul>

  <h2>Repositories</h2>
  <ul class="repos">
    <li><a href="https://github.com/expopush/expo-push">
      <strong>expopush/expo-push</strong>
      <span>The starter library — auto-configuration, backends, core client</span></a></li>
    <li><a href="https://github.com/expopush/test-harnesses">
      <strong>expopush/test-harnesses</strong>
      <span>Runnable Spring Boot apps exercising each backend end-to-end</span></a></li>
    <li><a href="https://github.com/expopush/test-target">
      <strong>expopush/test-target</strong>
      <span>Python simulator of the Expo push API, published to GHCR</span></a></li>
  </ul>

  <p style="margin-top:1.4rem;">Artifacts on
  <a href="https://central.sonatype.com/namespace/dev.expopush">Maven Central</a>
  under <code>dev.expopush</code> · Apache-2.0 licensed</p>

  <footer>
    This project is an independent, open-source work and is not affiliated with, endorsed
    by, or sponsored by 650 Industries, Inc. or the official Expo project. “Expo” is a
    trademark of 650 Industries, Inc.
  </footer>
</main>
</body>
</html>