Confusion around create-mn-app, network naming changes, and faucet access

While working with Midnight recently, I ran into a few inconsistencies between the CLI tooling, the documentation, and the available network infrastructure. I wanted to raise them here to understand the intended workflow and avoid using outdated setups.

1. Different project structures depending on the command

Running the following commands produces noticeably different project structures:

npx create-mn-app
npx create-mn-app@latest

The generated projects differ in folder structure and configuration, and they also reference different network naming conventions.

Additionally, the documentation sometimes suggests cloning the example repository:

git clone https://github.com/midnightntwrk/example-hello-world.git

However, that repository also has a structure that differs from both versions of create-mn-app.

So at the moment there seem to be three different starting points:

  1. create-mn-app

  2. create-mn-app@latest

  3. example-hello-world repo

It’s unclear which one should be considered the canonical or recommended starting template.


2. Network naming differences

The older tooling appears to use networks such as:

undeployed
preview
preprod

Whereas the newer scaffolding uses:

undeployed
testnet
mainnet

However, when asking about faucet access on Discord, I was advised to use the preprod network, which does not seem to be available in the newer project scaffolding.

This creates a situation where:

  • The faucet appears to be tied to preprod

  • The new CLI setup only exposes testnet

So it is not clear how to obtain test tokens using the newer setup.


3. Faucet link in the new CLI

When running create-mn-app@latest, the CLI also prints a faucet link for the testnet, but that link currently appears to be non-functional while requesting the tDUST tokens.


Questions

Could someone clarify the following points?

  1. Which project template should developers currently use:

    • create-mn-app

    • create-mn-app@latest

    • or the GitHub example repos?

  2. Is preprod still the correct network for faucet usage, and if so, how should it be configured when using the newer scaffolding that only references testnet?

  3. Is the ecosystem currently transitioning from preview/preprod to testnet/mainnet, and if so, what is the recommended development workflow during this transition?


Overall the tooling works well once the environment is running locally (undeployed network with simulators), but some clarity around network usage and project initialization would help a lot when setting up new projects.

Thanks in advance for any clarification.