Understanding Your Workspace
Every FoxNose setup is organized around three core building blocks: Organizations, Projects, and Environments. Understanding this hierarchy is the key to managing your applications effectively.
Here’s the basic structure:
Organization (e.g., Acme Corp)
└── Project (e.g., Support Agent)
├── Environment (e.g., Production)
├── Environment (e.g., Staging)
└── Environment (e.g., Development)
1. Understanding Organization
The Organization is the top-level container. It holds all your users, projects, and billing information. When you sign up, a personal organization is created for you.
- Contains: Users & Projects
- Controls: Billing & Subscriptions
2. Understanding Project
A Project contains all the data and configuration for a single application (e.g., your public website, a mobile app, or an internal knowledge base).
- Contains: Environments & a specific data region.
- Controls: The overall data architecture for one application.
When you create a project, you choose a geographic region where its data will be stored.
3. Understanding Environment
An Environment is a complete, isolated container for your project's data. Think of them as separate deployments of your application (production, staging, development). Each environment is assigned its own unique host, making all its APIs available on a distinct domain.
When you create a new environment, it starts empty. It does not automatically inherit data from other environments, ensuring a clean slate for testing or development.
- Contains: An independent set of your project's data.
- Controls: The content for a specific stage (live, testing, etc.).
By default, every new project comes with a Production environment. You can easily create more for development, testing, or previewing changes.