🧠 PolicyDraft.org Tutorial

📱 Mobile App Install Guide

PolicyDraft is available on both Android and iOS. Start by creating your account on the website, then install the app on your phone.

  1. Create your account on the website: PolicyDraft homepage.
  2. Android: install from Google Play: https://play.google.com/store/apps/details?id=org.policydraft.app
  3. iOS: install from the Apple App Store: https://apps.apple.com/gb/app/policydraft/id6759536608
  4. Open the app and sign in with the same email/password you used on the website.
  5. Complete sign-in with the email 2FA code.

🎯 Getting Started

Welcome to PolicyDraft.org! This is a collaborative, gamified knowledge graph platform where you can create, connect, and explore policy ideas through nodes and relationships.

📋 How to Join

PolicyDraft uses an invitation system to maintain quality. The default flow is waiting list first, then invite-based registration.

Step 1: Join the Waiting List

Start on the homepage with the waitlist form in the hero panel.

  1. Go to the homepage
  2. Enter your email and optionally your name
  3. Click "Join Waiting List"
  4. An admin reviews your request and sends an invite email when approved

Step 2: Register from the Invite URL

The approval email includes an Accept Invitation button with your invite code embedded in the URL.

  1. Open the invite email and click "Accept Invitation"
  2. You are taken to index.html?invite=...
  3. The sign-in modal opens directly in Register mode
  4. Your invite token is pre-filled in the registration form
  5. Complete account creation and sign in

📧 Approval Email (HTML format)

You're Invited!

You have been invited to join PolicyDraft.org.

Step 1: Register your account on the website.

Accept Invitation

The button opens an invite URL like:

https://www.policydraft.org/index.html?invite=abc123...

This URL auto-opens the Register tab and pre-fills the invitation token.

🔑 Signing In

PolicyDraft uses email-based two-factor authentication for security. Every sign-in requires a one-time code sent to your email.

  1. Click "Sign in" in the navbar
  2. Enter your email and password, then click "Sign in"
  3. A 6-digit access code is sent to your email
  4. Enter the code and click "Verify code" to complete sign-in
Registration Form

Create an Account

Full Name
Jane Doe
Email
jane@example.com
Password
••••••••
Confirm Password
••••••••
Invitation Token
abc123-invite-token
Sign-In Modal

Sign in

×
Email
jane@example.com
Password
••••••••
Access code
4 8 2 7 1 5

Forgot your password? · Register

Waiting List Form

Join the Waiting List

Don't have an invitation token yet? Join our waiting list and we'll send you one when a spot opens up.

Email
jane@example.com
Name (optional)
Jane Doe
The access code is sent via email every time you sign in. Check your inbox (and spam folder) for the code from PolicyDraft.org.

🔒 Forgot Your Password?

  1. On the sign-in form, click "Forgot your password?"
  2. Enter your registered email address
  3. Check your email for a password reset link (valid for 1 hour)
  4. Click the link and enter your new password

🎈 What Happens After You Sign In?

Once signed in, you'll be taken to the Graph workspace. From there you can:

  • Explore existing policy concepts on the interactive knowledge graph
  • Create your own nodes and connect them to others
  • Generate AI-powered whitepapers from your graph
  • Earn reputation as other users interact with your content
Start by exploring the existing graph to understand how nodes and connections work before creating your own content. Watch the token and reputation hints next to actions — they’re the quickest read on what spends your daily budget vs what earns someone else long-term standing.

📊 The Graph Workspace

The Graph is the heart of PolicyDraft. It's a full-screen interactive canvas where you create, explore, and connect policy concepts as visual nodes.

You're encouraged to zoom, pan, and click into nodes to understand small parts of the graph first. From there, make micro-contributions at your own pace and at your own level of analysis. Over time, these small contributions help you understand the gist of the whole graph.

🪙 Tokens & ⭐ Reputation (read this — it’s the real game)

PolicyDraft is intentionally scarce: your ability to act is bounded by a daily budget, while your long-term standing is tracked as reputation. The point is simple: high-signal contributions win — vague spam and “drive-by nodes” hit diminishing returns fast.

🪙 What “tokens” mean here

The UI calls your daily budget tokens because it’s easy to understand — but think of it as daily capacity that gets spent on graph + AI actions.

  • Daily limit scales with reputation (higher reputation → higher daily budget).
  • Role matters (admins/founders have a high floor; observers are capped).
  • Portfolio pressure is real: owning many active nodes (beyond a free tier) adds a daily “maintenance” draw on the same budget — so quality & consolidation beat infinite sprawl.
  • AI is expensive: essay + whitepaper buttons show dynamic costs because they consume a lot of budget.
  • Most graph writes are “1 token each”: creating a node costs 1; creating an edge costs 1 — “create connected node” is effectively 2 (node + edge).

⭐ What reputation is (and isn’t)

Reputation is not “points for clicking your own stuff.” It’s proof other people found your work useful.

  • Role base gives everyone a starting posture (from Observer → Founder).
  • Engagement from other users on your nodes is summed as activity_score in node_activity (self-interactions don’t count).
  • Thematic farming: when a thematic has real contribution activity in a day, owners of active nodes receive a daily bonus tied to how much happened and how “present” they are in that thematic.
  • Merge deactivation compensation: if your node is the deactivated side of a merge, you receive +5 reputation (in addition to token rewards on cross-user accepts).
Practical stakes: if you run out of daily budget, you’ll start getting 429 / daily_limit_reached-style blocks on actions — even if you “feel” like you still have ideas left. Reputation is how you earn back room to operate tomorrow, and how you climb leaderboards that other contributors actually look at.

🌾 Thematic farming (the “rising tide” rule)

When a thematic has contribution activity today, PolicyDraft recomputes a daily bonus for that thematic:

  • Owner bonus (per active node owner): max(0, total_contributions_today − your_own_contributions_today) × (your_active_nodes ÷ all_active_nodes)
  • Thematic owner uplift: (total_contributions_today ÷ max_nodes_owned_by_any_owner) × avg_nodes_owned
  • Anti-inflation guardrails: the farming base intentionally ignores synthetic payout rows (so the system can’t “farm itself”).

🧾 Engagement scoring (what moves the needle)

  • Views typically credit +1.0 activity score to the node owner (other users only).
  • Likes currently record +1.0 activity score as well (implementation detail: it’s logged under an activity row that behaves like a view-score path).
  • Connections credit +2.0 to each connected node owner (other users only) — connecting is one of the strongest “this matters” signals.

🗺️ Landing on the Graph

When you first open the Graph, you'll be prompted to load nodes. Choose a loading mode:

📋 Loading Modes

  • Saved Layout: Your previously saved workspace
  • Recently Worked On: Nodes you've interacted with recently
  • Most Visited: Your most frequently viewed nodes
  • All Nodes: Every active node in the system

🎨 Canvas Controls

  • Drag: Move nodes around
  • Zoom: Mouse wheel or pinch
  • Pan: Click and drag empty space
  • Delete/Backspace: Remove selected node from canvas

📌 Status Bar

The bottom of the screen shows your reputation score and daily token quota at a glance, so you always know how many actions you have left.

Graph Canvas
Climate
Action
Green
Energy
Carbon
Tax
Reputation: 24.5 Tokens: 18/25
Actions Menu

Actions

×
  • New Node 1 token
  • Upload Essay 5 tokens
  • Generate Whitepaper 10 tokens
  • My Created Nodes
  • Share Workspace
View Options
  • Fit to View
  • Clear Canvas
  • Connection Suggestions 3

🔍 Searching for Nodes

Use the search bar to find nodes by title or summary. Matching nodes are highlighted on the canvas.

carbon policy
Search
Carbon Tax — A mechanism to tax carbon emissions…
Carbon Pricing — Market-based pricing of CO2…

Note: search helps you find signal faster — it does not automatically grant reputation. Reputation comes from other users engaging with your nodes (views/likes/connections) plus thematic farming / merge compensation.

👆 Exploring Nodes

Click any node to open its details modal. From here you can:

  • View its title, type, summary, thematic, and tags — the node owner earns +1.0 activity score (counts toward reputation when the viewer isn’t the owner)
  • Like the node — the owner currently earns +1.0 activity score as well (free action for the liker; logged in a view-like scoring path today)
  • Expand — load all connected nodes onto your canvas
  • Center View — zoom and pan to focus on this node
  • Connect — start creating an edge from this node to another (counts against your daily budget)
  • Edit — modify title, summary, tags (only if you own the node) — free (no budget spend)
  • Propose Merge — suggest merging this node with one of yours

Node Details

×
Title
Green Energy Transition
Type
Roadmap
Status
ACTIVE
Summary
A comprehensive strategy for transitioning to renewable energy sources by 2040.
Thematic
Climate Policy
Tags
energy sustainability policy
👍 12 💬 3 comments

➕ Creating Nodes & Connections

There are three ways to add content to the graph:

Create a Node (1 token)

  1. Open the Actions menu and click "New Node"
  2. Fill in title (2–5 words), type, summary, and tags
  3. Click "Create Node" — it appears on the canvas

Create a Connection (1 token)

  1. Click a node and press "Connect"
  2. Click the target node on the canvas
  3. Choose a relationship type (e.g. "causes", "enables", "part_of")
  4. Each connected node’s owner earns +2.0 activity score from the connection event (other users only)

Create Connected Node (2 tokens: node + edge)

  1. Click a node and press "Create Connected Node"
  2. Fill in the new node details and relationship
  3. Both the node and edge are created in one step — that’s two quota increments (plus any maintenance reserve)
Create Node Modal

Create Node

×
Title (ideally 2–5 words)
Carbon Tax
Type
Policy
Summary
A mechanism to tax carbon emissions to incentivize green alternatives.
Tags
carbon × tax ×
Type to add tags...
Create Connected Node

Create Connected Node

×
Connecting from: Green Energy Transition
New Node Title
Solar Subsidies
Relationship
enables
Summary
Government subsidies to accelerate solar panel adoption.

📄 Uploading an Essay (Bulk Node Creation)

Paste an existing essay and let the AI extract nodes and connections automatically.

  1. Open the Actions menu and click "Upload Essay"
  2. Paste your essay content (up to 200,000 characters)
  3. Check the dynamic token cost displayed on the button
  4. Click "Process Essay" — the AI extracts nodes and connections
  5. Review the extracted nodes, select which ones to keep, and click "Create All"
Essay upload is ideal for quickly seeding the graph with a rich set of interconnected concepts from existing writing.

📂 Thematics & Workspace Organization

Thematics are topic categories that organize nodes into meaningful groups.

Browse & Load Thematics

  • Open the Thematics panel from the menu
  • Click "Load" on any thematic to populate your canvas with its nodes
  • Search or sort thematics by name or node count

Create a Thematic (-10 tokens)

  • No minimum reputation requirement
  • You become the thematic owner
  • Other users can contribute nodes to your thematic

Checkpoints

  • Save Checkpoint: Name and save your current workspace layout
  • Restore Checkpoint: Return to a previously saved state
  • Auto-save: Node positions are saved automatically as you work

Thematics

Create Thematic 10 tk
Climate Policy
28 nodes · 5 contributors
Load
AI Ethics
14 nodes · 3 contributors
Load

🔗 Connection Suggestions

The system identifies orphan nodes (nodes with no connections) and suggests potential links. A badge in the toolbar shows how many suggestions are available. Click it to review and connect orphaned nodes, strengthening the overall graph.

🔀 Proposing Merges from the Graph

If you spot a node that overlaps with one of yours, you can propose a merge directly from the node details:

  1. Click on the other user's node and select "Propose Merge"
  2. Choose which of your nodes to merge it with
  3. Optionally let the AI generate a merged title and summary
  4. The other user receives a notification and can accept or reject
  5. On acceptance, both users earn +3 to +5 tokens, and the source-node owner also receives +5 reputation for deactivation compensation.

⚡ Live Updates — What You See When Others Act

The graph updates in real time via Server-Sent Events. You'll see other users' activity as it happens:

New Node

When another user creates a node in your thematic, it animates onto the canvas with a green border and a toast notification.

Node Updated

When a node owner edits a visible node, it refreshes and flashes with an amber dashed border.

New Connection

When someone creates an edge involving visible nodes, the edge appears with a green highlight animation.

Merge Completed

When a merge completes, the source node fades out and the merged node highlights with a purple double border.

Live Canvas Notifications
🟢 New Node: "Urban Planning" created by Alice M. in Climate Policy
Updated: "Carbon Tax" was edited by its owner
🤝 Merged: "Renewable Credits" merged into "Green Energy Transition"

⭐ Reputation in Action on the Graph

As others interact with your content on the graph, you'll see reputation toasts appear in real time:

+1.0 rep — Someone viewed your node "Carbon Tax"
+2.0 rep — "Alice M." connected to your node

Your navbar badges update live: reputation score, daily token quota, and notification count all refresh without a page reload.

The loop is intentionally slow + scarce: publishing junk nodes burns tokens today without guaranteeing reputation tomorrow. The upside shows up when other people actually use your work (views/likes/connections), when your thematic is “alive” (farming), and when you help the graph converge (merges).

📚 Publications & Whitepapers

Publications are collaborative whitepapers generated from your knowledge graph. The full workflow goes: Generate → Edit Draft → Co-author Approval → Assign Author Roles → Publish.

📝 Step 1: Generate a Whitepaper

  1. Load the nodes you want to include onto your graph canvas
  2. Check the cost displayed on the button — it updates dynamically based on AI budget
  3. Click "Generate Whitepaper" from the Actions menu
  4. Wait for AI processing (typically 30–60 seconds)
  5. The whitepaper is created as a DRAFT and appears on the Publications page
The AI synthesizes all visible nodes and their connections into a structured document. The token cost is dynamic: it drops when AI budget is plentiful and rises when usage is high. Always check the button before generating.

✏️ Step 2: Edit the Draft

Once the AI generates the initial draft, you can refine it using the built-in rich-text editor.

  1. Go to the Publications page and find your draft
  2. Click "Edit Draft" to open the draft editor
  3. Use the Edit tab to modify the content with the rich-text (Tiptap) editor
  4. Click "Save Draft" — this creates a new version and resets all co-author approvals
Draft Editor — Edit Tab

Edit Draft

Edit Versions Approvals Authors
B I H1 H2 1.
1. Introduction
This whitepaper examines the intersection of climate policy and renewable energy transition strategies…

2. Carbon Taxation
We propose a progressive carbon tax starting at $25/tonne…
Version History — Versions Tab

Version History

Version 3 Current
Feb 15, 2026 · Jane D.
Version 2
Feb 13, 2026 · Jane D.
Compare with v3
Version 1
Feb 10, 2026 · AI Generated
Compare with v3
Every time you save the draft, a new version is created. You can compare any two versions side-by-side using the diff viewer.

✅ Step 3: Co-author Approvals

When a whitepaper is generated from a graph containing nodes created by multiple users, all node authors become co-authors and must approve the draft before it can be published.

  1. Open the draft editor and go to the Approvals tab
  2. See a list of all node authors (users who created nodes included in this publication)
  3. Each co-author reviews the draft and clicks "Approve Draft"
  4. If you edit and save the draft, all approvals are reset and co-authors must re-approve
  5. Use the "Nudge" button to send a reminder to co-authors who haven't approved yet (once per 24 hours)
Approvals Tab — Waiting for Approvals

Approvals

Jane D. (you — creator)
4 nodes in this publication
Approved
Bob T.
5 nodes in this publication
Pending
Alice M.
3 nodes in this publication
Pending
Co-author's View

Approve Draft

Jane D. has requested your approval for "Climate Policy Framework 2040". Your 5 nodes are included in this publication.

Please review the draft content and approve if you're satisfied. You can remove your approval later if needed.

Note: Saving a new version of the draft clears all existing approvals. Co-authors will need to review and approve again.

👥 Step 4: Assign Author Roles

Once all co-authors have approved, the Authors tab becomes available. Before publishing, you must assign author roles.

  1. Open the Authors tab (only visible after all approvals are in)
  2. Assign each co-author as either Lead or Contributing
  3. There must be exactly one Lead author
  4. Click "Save Author Roles" to confirm the assignments
  5. Optionally check "Make this publication public on the website" to make it visible to unauthenticated visitors
Authors Tab — Assign Roles

Author Roles

All Approved
Jane D.
Lead
Bob T.
Contributing
Alice M.
Contributing
Publication Pipeline Overview
1 Generate whitepaper from graph DRAFT
2 Edit & refine the draft
3 All co-authors approve
4 Assign Lead & Contributing authors
5 Publish PUBLISHED

🚀 Step 5: Publish

Once all approvals are in and author roles are assigned:

  1. Click "Publish Publication" in the Authors tab
  2. The draft content is promoted to the live publication body
  3. The status changes from DRAFT to PUBLISHED
  4. The publication becomes visible to all users (and to the public if the website checkbox was ticked)
After publishing, the content cannot be further edited. Make sure all co-authors are satisfied with the draft before publishing.

💬 Private Author Discussion

Co-authors have access to a private comments section on each publication, visible only to the co-authors of that publication.

  • Use it to discuss edits, suggest changes, or coordinate before approving
  • Comments are shown in the publication view modal under "Author Discussion"
  • Posting a comment notifies all other co-authors

📖 Browsing & Liking Publications

  1. Navigate to the Publications page from the navbar
  2. Browse published whitepapers — each card shows title, author, date, node count, and status
  3. Click "View whitepaper" to read the full content
  4. Click "Like" to endorse a publication — this currently acts as an endorsement + notification (publication-like reward is tracked separately from core node-activity reputation scoring)
  5. Your own DRAFT publications are visible only to you and your co-authors
Publication List

Climate Policy Framework 2040

By Jane D. (lead), Bob T., Alice M. · Feb 15, 2026 · 12 nodes PUBLISHED

A comprehensive whitepaper synthesizing insights from the Climate Policy thematic, covering carbon taxation, renewable incentives, and emission targets…

View whitepaper 👍 8

AI Ethics Discussion Draft

By Bob T. · Feb 8, 2026 · 5 nodes DRAFT

An initial exploration of ethical considerations in AI policy… (only visible to you)

Edit Draft Delete
Publication View Modal

Climate Policy Framework 2040

×
PUBLISHED Jane D. (lead) · 12 nodes
Authors: Jane D. — Lead Bob T. — Contributing Alice M. — Contributing
1. Introduction
This whitepaper examines the intersection of climate policy and renewable energy…
Author Discussion (co-authors only)
Bob T.: Looks great, approved!
Alice M.: Section 3 needs a citation for the IPCC data.
Solo publications: If all nodes in the whitepaper were created by you alone, you can skip the approval step and publish directly.

👤 Your Account

The Account page is your personal dashboard. Access it from the Account link in the navbar.

📊 Your Profile & Quota

At the top of the page you'll see your current status:

Reputation 54.5
Tokens Left 18 / 54
Role CONTRIBUTOR

Click "View User Levels" to see the roles (Observer, Contributor, Moderator, Admin, Founder) and what each can do.

🔔 Notifications

Your account page shows all notifications in one place. A red badge in the navbar shows your unread count, updated in real time via Server-Sent Events.

Notification types include:

  • Someone connected to your node (+2.0 rep)
  • Someone liked your node (currently +1.0 activity-score equivalent) or endorsed your publication (notification + tracked publication-like event)
  • A merge proposal needs your review
  • Your rank improved on the leaderboard (+10 points)
  • A publication approval is needed from you
  • An AI job (essay, whitepaper, merge) completed

Notifications 3

Mark all read
Alice M. connected to your node "Carbon Tax"
2 min ago · +2.0 rep
Bob T. liked your node "Green Energy"
15 min ago · +1.5 rep
Your rank improved to #3+10 points
Yesterday

📧 Nightly Digest Emails

Every night, you receive a digest email summarizing your day's activity:

📊 Node Activity

Views, likes, connections to your nodes, and your top 5 most active nodes.

📈 Reputation Change

Daily reputation gain, current total, breakdown by activity type, and rank movement.

💡 Recommendations

Personalized tips: connect orphaned nodes, review pending merges, like publications, and more.

Nightly Digest Email Preview
PolicyDraft.org
Your Daily Digest — Feb 10, 2026
24
Views
6
Likes
3
Connections
+12.5 points today
Total: 54.5 · Rank: #3 (+1)
Recommendations:
• 2 of your nodes have no connections — consider adding edges
• You have a pending merge proposal — review it to earn tokens

🔀 Merge Proposals

The Account page is where you manage all merge proposals. The AI runs nightly to identify duplicate or similar nodes.

Proposals for You

Other users (or the AI) have proposed merging one of their nodes with one of yours. Accept to earn +3 to +5 tokens each, or Reject.

Your Duplicate Nodes

The AI found duplicates among your own nodes. Click "Merge Now" to consolidate (no token reward, but cleans up your graph).

Your Proposed Merges

Merges you've sent to other users. Track their status or withdraw if no longer needed.

AI Merge Suggestion

AI Suggested
Carbon
Tax
by You
Carbon
Pricing
by Alice M.
Suggested title: Carbon Tax & Pricing
Reason: Both nodes cover the same concept of pricing carbon emissions.
Both users earn +3 tokens on accept

📝 Pending Publication Approvals

If your nodes are included in someone else's whitepaper, you'll see it here. You can approve the draft or nudge other co-authors who haven't approved yet.

🎟️ Invite Codes

Generate invitation codes to bring new users onto the platform. Your remaining invite count is shown, and you can copy a shareable link for each code.

⚙️ Settings

Change Password

Enter your current password and set a new one.

Change Email

Enter a new email and your password. A verification code is sent to confirm the change.

Active Sessions

View all active login sessions. Revoke any session you don't recognize.

Request Level Upgrade

Submit a request to be promoted (e.g. from Contributor to Moderator) with a reason.

Export Data

Download all your data as JSON (GDPR-compliant export).

Delete Account

Permanently delete your account. Requires password confirmation and a double confirm.

⚡ Live Updates on the Account Page

The Account page also receives real-time updates via Server-Sent Events:

  • Reputation toasts: When someone interacts with your content while you're on the page, a green toast shows your reputation gain
  • Notification badge: Updates in real time as new notifications arrive
  • User info refresh: Your reputation score and token count auto-refresh without reloading

🏆 Leaderboard

The Leaderboard shows how you compare to other contributors on the platform.

📊 Rankings

Top Contributors

Users ranked by total reputation score. See how many nodes and connections each user has created.

Top Risers (30 days)

Users with the biggest reputation gains over the past 30 days. Great for spotting active contributors.

Search Users

Search for any user by name or email. Click a user to see their expertise breakdown by topic area.

Leaderboard

Top Contributors

# User Reputation 30-Day
1 Alice M. 142.5 +38.2
2 Bob T. 98.0 +22.7
3 You 54.5 +12.0
Expertise Modal (click any user)

Alice M. — Expertise

×
Total: 142.5 reputation
Climate Policy 68.0
AI Ethics 42.5
Economic Reform 32.0

📈 Daily Ranking Bonus

If your rank improves compared to the previous day, you earn +10 reputation points per rank gained. You can never lose points from rank changes — it's a one-way bonus.

Check the leaderboard regularly to track your progress. Your expertise breakdown shows which topic areas you're strongest in.

🎮 Gamification Reference

This section is a complete reference for the reputation and token system. For a quick overview, look for the indicators next to buttons throughout the app.

📖 How to Read the Indicators

  • ⭐ +rep = Content owner gets reputation when you do this action
  • ⭐ +X.X = Content owner gets X.X points when you do this
  • ⭐ -X tokens = This action costs X tokens (uses your daily quota)
  • ⭐ +X tokens = This action gives you X tokens

Key Insight: You earn reputation when others interact with your content, not when you create it!

🌾 Thematic Farming & Merge Compensation

  • Thematic farming (daily): in each thematic with contribution activity, active-node owners earn a bonus based on (total contributions - your own) × your active-node share.
  • Thematic owner uplift (daily): thematic owners get an additional bonus: (total contributions / max owner node count) × average owner node count.
  • Merge deactivation compensation: when your node is deactivated as the source during a completed merge, you receive +5 reputation in addition to any token compensation.

💰 Token Costs

Content Creation

  • Create Node: 1 token (from your daily quota)
  • Edit Node: free (owner only)
  • Create Edge: 1 token
  • Create Connected Node: 2 tokens (node + edge)
  • Upload Essay: dynamic (shown on the button; scales with AI budget)
  • Generate Whitepaper: dynamic (shown on the button; scales with AI budget)
  • Create Thematic: 10 tokens (UI may mirror whitepaper pricing in places)
  • Portfolio maintenance: automatic reserve (large portfolios reduce “headroom” before you click anything)

Reputation Rewards (to owner)

  • View Node: +1.0
  • Connect to Node: +2.0
  • Like Node: +1.0 (free for the liker; counts for the owner)
  • Like Publication: endorsement + notification (tracked separately)
  • Thematic Farming (daily): activity-share bonus for active-node owners in active thematics
  • Thematic Owner Uplift (daily): extra ownership bonus on contribution-active thematics
  • Merge Source Deactivation: +5.0 reputation

📊 Daily Quota by Role

OBSERVER

0 tokens/day

Read-only access

NEWBIE / CONTRIBUTOR

max(10, floor(reputation))

Scales with reputation (admins can also set a per-user floor via min_daily_token_limit)

MODERATOR

max(10, reputation)

Higher floor than newbie/contributor paths once your rep exceeds 10

ADMIN / FOUNDER

100 tokens/day

High cap for platform operators

📊 Dynamic AI Costs

AI-powered features use dynamic pricing: costs drop when AI budget is plentiful (as low as ~50% of base) and rise when tight (up to ~5x). The exact cost is always shown on the button.

Self-interactions don't count. You don't earn reputation from viewing or expanding your own nodes. Only you can edit your own nodes. Quota resets at midnight each day.

⚙️ Admin Panel ADMIN FOUNDER

The Admin page is only visible to users with the Admin or Founder role.

User Management

  • Search users by name or email
  • View roles, reputation, and node counts
  • Update user roles

Waiting List

  • View pending waiting list requests
  • Send invitation tokens by email

AI Operations

  • Trigger AI Merges: Run the merge proposal engine on demand
  • Auto-Tag Nodes: Let AI suggest and apply tags to untagged nodes
  • AI-Flagged Nodes: Review nodes flagged as frivolous or low-quality

Platform Management

  • Recalculate Reputation: Rebuild all reputation scores from event history
  • OpenAI Budget: View usage and set monthly AI budget limits
  • Deactivate Nodes: Hide nodes from all users (from the Graph page)
User Management Panel

Users

Search users…
Name Role Rep Nodes
Alice M. CONTRIBUTOR 142.5 38
Charlie K. OBSERVER 0 0
Node Deactivation (from Graph)

Admin Actions

Confirm Deactivation
This will deactivate 12 nodes currently visible on the canvas.
Deactivate All (12) Cancel
Deactivating a node hides it from all users and API responses. This action is logged and should be used carefully.

🧭 Navigation Icons

Use this quick legend when moving around the app. The icons below match the exact mobile navbar icon set.

Main Navigation

  • Home: Landing page, sign-in/register, and waitlist
  • Graph: Main workspace for nodes, edges, and thematics
  • Publications: Whitepaper list, drafts, and editing
  • Leaderboard: Reputation and expertise rankings

Account & Alerts

  • Account: Profile, sessions, notifications, and export tools
  • Notifications: Open your notifications page (with unread badge)
  • 🔴 Red badge number: Unread notification count (live updates)
  • Tutorial: Help and platform walkthrough
  • Admin: Admin-only controls (visible for ADMIN/FOUNDER roles)

Graph Menu & Overflow

  • ☰ Graph menu button: Opens graph actions and thematic controls
  • More: Opens overflow links on mobile nav
  • ✨ Feature Tour: Reopens the guided onboarding tour
  • 📝 Upload Essay: Convert essay text into candidate nodes/edges
  • 📄 Generate Whitepaper: Create publication drafts from selected nodes
If you are on mobile, start with the graph menu button to access most actions in one place.

⌨️ Keyboard Shortcuts

Canvas Navigation

  • Mouse Wheel: Zoom in/out
  • Click + Drag: Pan around
  • Double-click: Reset zoom

Node Operations

  • Delete/Backspace: Remove selected node from canvas
  • Click: Select node
  • Drag: Move node

General

  • Enter: Submit forms
  • Escape: Close modals
  • Tab: Navigate form fields

🔧 Troubleshooting

Can't create nodes or connections

  • Check your daily token quota in the status bar
  • Ensure you're signed in
  • Try refreshing the page

Nodes not appearing

  • Try different loading modes (Saved Layout, All Nodes, etc.)
  • Check if nodes were deactivated by an admin
  • Clear browser cache and refresh

Whitepaper generation fails

  • Ensure you have enough tokens (check the cost on the button)
  • Check your internet connection
  • Wait a moment and try again — AI budget may have been temporarily exhausted

Not receiving emails (access codes, digests)

  • Check your spam/junk folder for emails from PolicyDraft.org
  • Verify your email address is correct on the Account page
  • Contact an admin if the issue persists

Admin features not visible

  • Verify you have the ADMIN or FOUNDER role
  • Sign out and sign back in
  • Contact a founder for role assignment

📞 Getting Help

If you need assistance:

  • Check this tutorial for common solutions
  • Contact an admin for technical issues
  • Report bugs through the admin interface
  • Suggest features to improve the platform
The PolicyDraft.org community thrives on collaboration. Don't hesitate to reach out if you have questions or ideas!