NS Pulse

Live site: https://nspulse.xyz

Stats dashboard for NS, including info on monthly events, member countries and talents. Built using QuickDapp.

Getting Started

Requires:

• Node.js
• Bun
• Docker

Install dependencies

bun i

Start the database server in a separate terminal:

docker compose up --build

Setup database schema:

bun run db push

Get an Anthropic API key and place it in .env.local:

ANTHROPIC_API_KEY=

Run the dev server:

bun run dev

Hot-module reload is now enabled (except for changes to .env files). Access the site at http://localhost:5173

Data sources

Events

Event data is fetched directly from the NS calendar and then processed via Claude.

Members

1. Use DiscordChatExporter to export:

• #reception channel -> ./data/reception.csv

2. Run bun run scripts/parseReceptionCsv.ts
3. Check that ./src/shared/stats/reception.json exists.

Note: If the script fails halfway you can re-run it and it will resume from where it left off. To force a fresh run delete the .parseReception.progress file in the root folder.

Ideas

1. Use DiscordChatExporter to export:

• #discussion channel -> ./data/discussion.csv

2. Run bun run scripts/parseDiscussionCsv.ts
3. Check that ./src/shared/stats/discussion.json exists.

Note: If the script fails halfway you can re-run it and it will resume from where it left off. To force a fresh run delete the .parseDiscussion.progress file in the root folder.

Deployment

The Docker Build & Push workflow auto-runs on main branch pushes, building the nspulse image. This then gets deployed to DigitalOcean.

License

MIT — see LICENSE.md