# DashForDevs Docs

> DashForDevs is ecommerce and business software: a dashboard for owners, a public API (https://papi.dashfordevs.com) and the dash4devs SDK for developers, and DashForDevs Cloud for hosting. These docs are written for business owners, developers and AI agents.

Rules for agents: never expose an sk_ secret key (server-side only); never put personal data into public content (blog, page groups, media); create content as drafts unless told to publish; treat 501 not_implemented and 503 not_available_yet as final. Details: https://docs.dashfordevs.com/v1/ai-agents/read-this-first.md


## Start here


### Start here

- [What DashForDevs is](https://docs.dashfordevs.com/v1/introduction/what-is-dashfordevs.md): One platform to run an online business, and one API to build on it.
- [Which docs are for you](https://docs.dashfordevs.com/v1/introduction/choose-your-path.md): Three readers, three paths. Pick yours and skip the rest.
- [Glossary](https://docs.dashfordevs.com/v1/introduction/glossary.md): The words these docs use, in one place.
- [About CodeCraft Studios](https://docs.dashfordevs.com/v1/introduction/about-codecraft-studios.md): The company behind DashForDevs.
- [Are we for you?](https://docs.dashfordevs.com/v1/introduction/are-we-for-you.md): An honest answer, before you spend an afternoon finding out.

## Business owners


### Your first day

- [Create your account](https://docs.dashfordevs.com/v1/business-getting-started/create-your-account.md): One account signs you in to every DashForDevs product.
- [Set up your organization](https://docs.dashfordevs.com/v1/business-getting-started/set-up-your-organization.md): Your business on DashForDevs, with its profile, settings and team.
- [Invite your team and set roles](https://docs.dashfordevs.com/v1/business-getting-started/invite-your-team.md): Give each person exactly the access their job needs.
- [Turn on two-factor sign-in](https://docs.dashfordevs.com/v1/business-getting-started/two-factor-sign-in.md): A code from your phone, on top of your password.

### Products and stock

- [Add a product](https://docs.dashfordevs.com/v1/products/add-a-product.md): From an empty catalog to a product your site can sell, in about five minutes.
- [Organize with categories, brands and variations](https://docs.dashfordevs.com/v1/products/organize-your-catalog.md): Structure that makes your catalog easy to browse, filter and manage.
- [Keep stock right](https://docs.dashfordevs.com/v1/products/stock-and-locations.md): How stock is counted, reserved and moved between locations.
- [Edit many products at once](https://docs.dashfordevs.com/v1/products/bulk-edit.md): Bulk edit and import for when one at a time is too slow.

### Orders

- [The life of an order](https://docs.dashfordevs.com/v1/orders/life-of-an-order.md): Every stage an order goes through, and what you do at each.
- [Create an order for a customer](https://docs.dashfordevs.com/v1/orders/create-an-order.md): Phone orders, counter sales and custom quotes, made by you in the dashboard.
- [Ship an order](https://docs.dashfordevs.com/v1/orders/ship-an-order.md): Labels, tracking and the states you do not ship to.

### Customers and calendar

- [Your customers](https://docs.dashfordevs.com/v1/customers/your-customers.md): Everyone who has bought, booked or signed up, in one list.
- [Calendar and appointments](https://docs.dashfordevs.com/v1/customers/calendar-and-appointments.md): Let customers book time with you, on the hours you choose.

### Marketing and content

- [Write a blog post](https://docs.dashfordevs.com/v1/marketing/write-a-blog-post.md): Write, schedule and publish posts your site shows automatically.
- [Page groups: your own content types](https://docs.dashfordevs.com/v1/marketing/page-groups.md): Services, team members, FAQs, locations. Define the fields once, fill them in, your site shows them.
- [The media library](https://docs.dashfordevs.com/v1/marketing/media-library.md): Every image, video and file, in folders, served fast.
- [Discounts and promotions](https://docs.dashfordevs.com/v1/marketing/discounts.md): Codes, tiers, buy-one-get-one, customer pricing and a points store.

### Analytics, payments and finance

- [Analytics without tracking people](https://docs.dashfordevs.com/v1/analytics-and-money/analytics.md): Visits, sources, funnels and carts, with no personal data stored at all.
- [Take payments](https://docs.dashfordevs.com/v1/analytics-and-money/payments.md): Connect your processor. Card numbers never touch your site or ours.
- [Finance and tax](https://docs.dashfordevs.com/v1/analytics-and-money/finance-and-tax.md): What came in, what went out, and the tax on each sale.
- [Your plan and invoices](https://docs.dashfordevs.com/v1/analytics-and-money/your-plan-and-invoices.md): What you pay DashForDevs, and where to see it.

### Privacy, security and HIPAA

- [How we protect your data](https://docs.dashfordevs.com/v1/privacy-and-security/how-we-protect-your-data.md): The short version for owners. The technical version is in the security model.
- [HIPAA and health data](https://docs.dashfordevs.com/v1/privacy-and-security/hipaa.md): If you sell health products or see patients, read this before importing customers.

## Developers


### Quickstart

- [Your first API call](https://docs.dashfordevs.com/v1/getting-started/first-api-call.md): A key, one request, real data. Five minutes.
- [Build a storefront page with the SDK](https://docs.dashfordevs.com/v1/getting-started/storefront-with-the-sdk.md): A Next.js product list and product page, server-rendered, in a few files.

### How the platform works

- [Architecture overview](https://docs.dashfordevs.com/v1/how-it-works/architecture.md): One public door, one private corridor, and a service for each kind of data.
- [Identity and sign-in](https://docs.dashfordevs.com/v1/how-it-works/identity-and-sign-in.md): How people prove who they are, and how every app trusts that.
- [Events, traces and audit logs](https://docs.dashfordevs.com/v1/how-it-works/events-and-logs.md): How services tell each other what happened, and how every action is recorded.
- [Versioning and compatibility](https://docs.dashfordevs.com/v1/how-it-works/versioning.md): What v1 promises, and how changes reach you without breaking you.

### API keys and authentication

- [Public and secret keys](https://docs.dashfordevs.com/v1/authentication/public-and-secret-keys.md): The single most important page for anyone shipping a site.
- [Allowed origins](https://docs.dashfordevs.com/v1/authentication/allowed-origins.md): Which websites may use your live public key.
- [Rotating keys, and what to do when one leaks](https://docs.dashfordevs.com/v1/authentication/rotate-and-leaks.md): Rotation without downtime, and a five-minute leak checklist.

### Automations and webhooks

- [Outgoing webhooks](https://docs.dashfordevs.com/v1/webhooks/outgoing-webhooks.md): We call your URL when something happens. Here is how to trust the call.
- [Flows](https://docs.dashfordevs.com/v1/webhooks/flows.md): When this happens, do that. Built visually, run reliably.

### Errors and rate limits

- [Error responses](https://docs.dashfordevs.com/v1/error-handling/errors.md): One shape, stable codes, and what to do about each.
- [Rate limits](https://docs.dashfordevs.com/v1/error-handling/rate-limits.md): Per key, per minute, with headers that tell you where you stand.

### The dash4devs SDK

- [Install and configure](https://docs.dashfordevs.com/v1/sdk/install-and-configure.md): One client, a handful of options, sensible defaults.
- [Modules](https://docs.dashfordevs.com/v1/sdk/modules.md): Every area of the API, as a property of the client.
- [Images with DashImage](https://docs.dashfordevs.com/v1/sdk/images.md): The right size for every screen, from the CDN.
- [The dash4devs CLI](https://docs.dashfordevs.com/v1/sdk/cli.md): Scaffold a store, build it, ship its assets to the CDN.

### DashForDevs Cloud

- [What Cloud is](https://docs.dashfordevs.com/v1/cloud/overview.md): Hosting in the same account as your business, on AWS, without managing AWS.
- [Deploy an app from GitHub](https://docs.dashfordevs.com/v1/cloud/deploy-an-app.md): Connect a repository once. Every push after that deploys itself.
- [Managed databases](https://docs.dashfordevs.com/v1/cloud/databases.md): PostgreSQL you do not have to run.
- [Cloud billing](https://docs.dashfordevs.com/v1/cloud/billing.md): Pay as you go, per resource-hour, capped at a monthly price.

### Security model

- [The security model](https://docs.dashfordevs.com/v1/security/security-model.md): Defense in depth, written down, so you can check our work.

### Storefront API reference

- [Overview](https://docs.dashfordevs.com/v1/api-reference/overview.md): Every public route, by area, straight from the gateway.
- [Catalog](https://docs.dashfordevs.com/v1/api-reference/catalog.md): Products, categories, brands, reviews, lab reports and stock.
- [Cart, checkout and orders](https://docs.dashfordevs.com/v1/api-reference/cart-checkout-orders.md): Carts, checkout, orders, discounts, loyalty, referrals, affiliates and tax.
- [Customers and calendar](https://docs.dashfordevs.com/v1/api-reference/customers-and-calendar.md): Shopper accounts, profiles, list subscriptions, calendar availability and booking.
- [Content](https://docs.dashfordevs.com/v1/api-reference/content.md): Pages, global data, blog, page groups, media, legal documents and docs.
- [Forms and email](https://docs.dashfordevs.com/v1/api-reference/forms-and-email.md): Contact forms, newsletters and email.
- [Shipping](https://docs.dashfordevs.com/v1/api-reference/shipping.md): Shipping rates and options.
- [Payments](https://docs.dashfordevs.com/v1/api-reference/payments.md): Storefront payments and processor webhooks.
- [Analytics](https://docs.dashfordevs.com/v1/api-reference/analytics.md): Privacy-first tracking and insights.
- [Automations](https://docs.dashfordevs.com/v1/api-reference/automations.md): Inbound webhooks for flows.
- [Billing](https://docs.dashfordevs.com/v1/api-reference/billing.md): Platform billing webhooks.
- [Platforms](https://docs.dashfordevs.com/v1/api-reference/platforms.md): White-label platform routes.
- [Gateway](https://docs.dashfordevs.com/v1/api-reference/gateway.md): Routes papi answers itself.
- [Admin API (secret key)](https://docs.dashfordevs.com/v1/api-reference/admin-api.md): Write to your organization from your server, with the secret key.

## AI agents


### For AI agents

- [Read this first (agents)](https://docs.dashfordevs.com/v1/ai-agents/read-this-first.md): Facts and rules for an AI model working with DashForDevs.
- [Connect an assistant (MCP)](https://docs.dashfordevs.com/v1/ai-agents/connect-an-assistant.md): Let Claude write posts, update pages and read forms for one organization.
- [Build a DashForDevs site with an AI coding agent](https://docs.dashfordevs.com/v1/ai-agents/build-with-ai.md): Give the agent the right context and the right guardrails.

## Optional

- [Everything in one file](https://docs.dashfordevs.com/llms-full.txt)