How to use devreport, start to finish.

Quick start

devreport turns a git repo, or a pile of notes, CSVs, logs and screenshots, into a PDF slide deck or report. It reads your material, plans the story, draws the charts from your own data and typesets the result. Usually three to five minutes, a little longer for a big repo.

1. Give it your materialPaste a repo link, drop files, or both.
2. Pick slides or a reportChoose the length and a theme, then press Generate slides.
3. Fix what you wantAsk for changes in plain words, or edit the page yourself.

New accounts get 15 free credits, enough for your first deck. See credits and pricing.

What to give it

The deck can only be as good as what it reads. It never invents numbers, users or results: when something isn't in your material, it leaves it out.

A repo

Paste any GitHub, GitLab, Codeberg or other git link. It reads the README, the code, the docs and the history, but never runs your code. What helps most:

• A README that says what the project does and who it's for. The first screen of your README usually becomes the first slides.
• Results written down. Benchmark tables in the README, CSVs, logs and notebooks become charts. Numbers that only live in your head can't.
• Screenshots or diagrams. Images hosted on GitHub can go on the slides, and Mermaid diagrams are redrawn in the deck's theme.

Files

Drop anything next to the repo, or instead of it: notes (.md, .txt), CSVs, logs, screenshots, PDFs or a .zip of a folder. You can also paste a screenshot straight into the drop zone.

Only part of a repo

Under What should it cover? pick Pull requests, Some commits or A range (like main..dev) to make a deck about just that work: a sprint review, a release, what changed this month. A PR, commit or compare link pasted into the repo field works too.

Private repos

Click Connect GitHub under the repo field and pick the repos it may read. Access is read-only, and the clone is deleted after the build.

Starting a document

In the app, New has three parts.

01 Source

The repo link and the drop zone, as above. You need at least one of them.

02 Format

• Slides: a 16:9 deck, 5 to 25 slides (6 by default).
• Report: A4 pages, 2 to 10 (4 by default).
• The length is exact unless your material runs out; it will stop short rather than pad.
• Follow a template (slides): for rounds judged on a fixed format. SIH idea deck (6 slides) follows the Smart India Hackathon idea headings; pick the SIH 2026 theme too for the official template's look (more on SIH). My organiser's .pptx takes an uploaded template's slide order and headings, one slide per template slide. The template sets the length.

03 Theme

49 slide themes and four report styles. Each card shows a real page in that theme. Don't agonise: you can switch themes for free once it's built. Your template takes the colours, fonts and logo from a .pptx or .potx (up to 30 MB).

Press Generate slides (or ⌘ ↵). The button shows the cost, and tells you what's missing if it can't start yet.

Its questions

After reading, it may ask up to four short questions, one at a time: usually which deck you want (a pitch, a technical walkthrough, a project review), the result to lead with, the team, and how to end. Some questions have option buttons (keys 1–4).

• Answer in a sentence or two. You can paste screenshots into an answer.
• Skip this one or Skip all, use what you have if you're in a hurry. It goes with what the material says.
• Close the tab and it emails you the questions, with one-tap answers.

While it builds

You see each step as it happens: reading the repo, planning, writing, compiling and checking. You don't have to watch. You can close this tab: the build carries on, lands in your Library, and you get an email when it's ready.

Before it finishes, it checks its own work: overfull slides, wrapped titles, repeated points, and every number on a page traced back to a source file. A build that fails gives its credits back. Cancel stops a build and refunds it too.

Your finished document

The finished deck opens in the viewer. Along the top: the version (v1), PDF, Edit, Theme, Fonts, page arrows, Request changes, Share, Run again and Present. Pages on the left, the page you're on in the middle.

There are two ways to change it:

Every AI change makes a new version. Click versions to open any earlier PDF.

Request changes (AI)

Click Request changes: it opens with a note for the page you're on, ready to type (it follows you while it's empty), or use Note on this page on any page. You can combine:

• Whole deck: feedback on everything, like tone, titles or density.
• Notes on a page: + Note on a page, as many as you need. The best changes are page notes.
• Length: the stepper adds or removes slides. It adds what your material left out and never pads.
• Add material: new files, a zip, a repo link or a paragraph of news, folded into the deck.

Press Apply changes. It edits only what you asked and keeps everything else. If anything fails, your last good version stays and the credit comes back.

Write requests that land

Reviewers you shared a link with can comment on pages. Their comments show under Request changes, and Use as notes turns them into page notes.

Edit by hand

Click Edit, then click anything on the page. Changes save as you make them, cost nothing and don't use the AI.

Text

• Click a line to edit its words. The text bar has font, size, A− A+, bold, italic, underline, strikethrough, highlight and links (⌘ K).
• The panel on the right styles a whole block: font, size, colour, rotation and link, with resets.
• Some text can't be edited by hand, and says why: text that appears more than once, or that comes from your data or the theme. Change that with Request changes.

Charts, tables and pictures

• Drag a chart, table, picture or text block to move it. Resize from the handles, and turn it from just outside a corner.
• Switch a chart between Bars, Line, Pie, Table and Dots.
• In a table, rename, reorder or delete columns, and drag or delete rows.
• Replace image… swaps a picture for another of yours, and Reset position/size/rotation undoes moves.

Add your own

The Insert buttons add Text boxes, an Image (cropped to a rectangle, rounded or circle), a Shape (box, circle, line, arrow) or a freehand Drawing. Each one has opacity, rotation and In front / Behind text. Layers lists everything on the page, to show, hide, reorder or delete.

Handy keys

Themes, fonts and colours

All of these re-typeset your deck with no AI, so they're free and take about two seconds.

• Theme: any of the 49 slide themes (or four report styles). Hover a theme to preview your own deck in it. Browse them all on the themes page.
• Fonts: separate fonts for titles, body and captions.
• In the Theme menu: Padding (Compact, Normal, Roomy), Colours (accent, background, text), and on decks built from a repo, Commit history on the cover.
• Upload a theme… restyles the deck in a .pptx's colours, fonts and logo (2 credits; picking Your template when you start a deck costs the same, on top of the build). Make a theme… builds your own theme to reuse (experimental).

Present, share, download

Present

Present shows the deck full screen in the browser, and links in it are clickable.

Share

Share → Create and copy a link. Anyone with the link can view the PDF and, once signed in, comment on a page. They never see your files. Revoke turns a link off.

Download

PDF downloads the current version. PDF is what most hackathon and college rounds ask for, and it looks the same on every laptop. PowerPoint (.pptx), for slide decks, costs 2 credits once per version, and downloading it again is free. Titles and text come as editable text boxes; charts, code and pictures come as pictures.

Run again with new files

Run again makes the next edition: same format, theme and layout, built from new files (a monthly report, the next sprint). Drop the new files, optionally say what changed, and press Build the new edition. The original stays as it is. It costs 10 credits.

Credits and pricing

Top up on the Credits page. Packs are one-time payments and credits never expire: 30 credits for ₹49, 70 credits for ₹99, 160 credits for ₹199. Paid decks have no “Made with devreport” footer: after your first pack it comes off each deck in that workspace the next time you build, change or re-theme it. If you signed up with an event code, your decks have no footer until the event’s date.

Invite friends from the same page: when someone you invite finishes their first build, you both get 30 credits.

Keyboard shortcuts

On Windows and Linux, use Ctrl where it says ⌘.

Limits and troubleshooting

• Uploads: up to 50 MB at a time (a zip may unpack to 200 MB); 1 GB of storage per account. Delete old documents in the Library to make room.
• Repos: up to 500 MB. A private repo needs Connect GitHub first.
• At once: up to 3 builds running or queued per account.
• A slide says less than you hoped: it only uses what your material says. Add a notes file or answer its questions, then Request changes with Add material.
• A number is missing: it leaves out numbers it can't trace to a file. Put the number in a note or a CSV and ask again.
• Text won't edit by hand: it comes from your data, the theme, or appears twice. Use Request changes.
• A build failed: your credits came back. The Library card says why and has Try again.

Still stuck? Contact us.